If you’ve tried accessing a settings page inside Rank Math but instead greeted with an error page “Sorry, you are not allowed to access this page.” as shown below, then you’ve come to the right place. This error denotes that you don’t have the required permissions to view the page or save the changes.
How to Diagnose & Fix WordPress Permissions
You can come across this permissions error for a number of reasons. And in this knowledgebase article, we’ll help you troubleshoot the issue and walk you through the steps to fix them.
1 Check If You’re Using Admin Account
To access some of the settings inside Rank Math, you’ll need to have relevant user capabilities. If you’re unable to access a specific page, at first, check if you are using an admin account. By default, an administrator account is set to have all user capabilities. Next, try accessing the same page with an admin account to see if the issue is fixed.
If the issue still persists, proceed to the next step.
2 Check Your Access with Role Manager
The next step is to check if you’ve access to Role Manager settings inside Rank Math.
If you’ve access to Role Manager, ensure that your user role has been granted with all the required user capabilities. After enabling the required user capabilities, click the Update Capabilities button at the bottom of the page to reflect the changes.
Now, check if the issue has been resolved.
If you’re still facing the issue, proceed with the following steps.
3 Check If You’ve Activated Rank Math Network-Wide
If you’re working in a multisite environment, this error is most likely to occur when Rank Math is not installed in the correct way. We recommend following our detailed tutorial on installing Rank Math in a multisite environment.
If you plan to use Rank Math throughout your network, you’ll need to install and Network Activate Rank Math plugin. However, if you wanted to use Rank Math only on specific sub-sites, then you need to install Rank Math in the network (but not activated) and then activate the plugin in the specific sub-sites.
Note: Site admins cannot install a new plugin on their own, and only the Super admin can install the Rank Math plugin on the Network Admin. Once the Rank Math plugin is installed network-wide, the site admins can only activate or deactivate Rank Math on their sub-site.
4 Uninstall Rank Math & Install Again
The last method is to uninstall the Rank Math plugin completely and then install once again.
Caution: During this uninstallation process, you will lose all the Rank Math data, including your settings and metadata for your posts, terms, and users. Hence we recommend you to backup all your Rank Math configurations and post data to your computer before proceeding further.
Exporting Rank Math Settings: You can use the Export Settings feature of Rank Math to save a copy of your Rank Math settings to your computer.
Exporting Rank Math SEO Metadata: If you’re a Rank Math PRO user, you can save a copy of your SEO metadata as a CSV file to your computer. If you’re a Rank Math Free user, you can use the Export option inside your WordPress dashboard to create a backup of your website in XML format.
Once you’ve created a backup, add the following code snippet to your theme’s functions.php file.
/** * Filter to remove Rank Math data from the database */ add_filter( 'rank_math_clear_data_on_uninstall', '__return_true' );
Then, deactivate & uninstall the Rank Math plugin from your Plugins page inside your WordPress admin area.
Now, install the Rank Math plugin once again and check if the issue is fixed. Once the issue has been resolved,
- Import your Rank Math settings using the Import Settings feature of Rank Math
- Next, you’ll have to import your SEO metadata. If you’ve used the CSV method, you can import the CSV file as shown in this tutorial. Instead, if you’ve created a backup of your website’s data with an XML, use the WordPress Importer to restore the metadata.
- And, that’s it!
We hope you were able to resolve the issue. If you’re still facing this error, please feel free to reach our support team, as we’re always here to help.