ThisCalculator

Everyday

How to Add an SEO Editor Role in WordPress

Updated · Standard formula, shown below

This guide shows you how to create a custom user role called “SEO Editor” in WordPress. This role gives a team member access to edit posts, pages, and on-page SEO settings without giving them full administrator powers. You’ll need WordPress admin access and a plugin like User Role Editor (free version works) or the free Code Snippets plugin.

What You’ll Need

  • WordPress admin account (username and password)
  • FTP or file manager access (if you choose the manual code method)
  • A plugin like User Role Editor or Code Snippets (both free)
  • Knowledge of which SEO plugin you use (e.g., Yoast SEO, Rank Math, All in One SEO)

Step-by-Step

  1. Back up your site. Before changing roles or installing plugins, create a full backup of your database and files. Use a backup plugin or your hosting control panel.
  2. Install and activate the User Role Editor plugin. Go to Plugins → Add New, search for “User Role Editor”, install, and activate.
  3. Open the User Role Editor. After activation, go to Users → User Role Editor in the admin menu.
  4. Choose the “Editor” role as a base. In the “Select Role” dropdown at the top, choose “Editor” and click “Load”. This gives you a starting point that already has most editing capabilities.
  5. Add a new role. Click the “Add Role” button. In the popup, enter “SEO Editor” as the Role ID (use underscores, e.g., seo_editor) and “SEO Editor” as the Display Name. Click “Add Role”.
  6. Copy capabilities from Editor. After creating the role, you’ll see a list of capabilities. To save time, click the “Copy from” dropdown and select “Editor”, then click “Copy”. This assigns all Editor capabilities to your new role.
  7. Add SEO plugin capabilities (if needed). Scroll through the list. If you use Yoast SEO, look for capabilities like wpseo_bulk_edit, wpseo_edit_advanced_meta, or wpseo_manage_options. For Rank Math, check for rank_math_edit_article or rank_math_manage_options. Check the boxes for the ones you want. If you don’t see them, the SEO plugin may not register its capabilities with the role editor—see Troubleshooting.
  8. Save the role. Click “Update” to save your changes. The new role is now available under Users → Add New.
  9. Assign the role to a user. Go to Users → All Users, click “Edit” under the user you want, and under “Role” select “SEO Editor”. Click “Update User”.
  10. Test the role. Log out of WordPress and log in with the test user’s credentials. Verify they can edit posts and pages, and that they can access the SEO settings you intended. They should not see “Appearance”, “Plugins”, or “Settings” menus.

Common Mistakes

  • Giving too many capabilities. If you copy from Administrator, the SEO Editor could accidentally delete themes or change site settings. Stick with Editor as the base.
  • Forgetting to update the SEO plugin’s permissions. Many SEO plugins have their own capability settings. For example, Yoast SEO has a “SEO Manager” role built-in. You might need to assign that role separately.
  • Using a plugin that doesn’t support custom roles. Some SEO plugins only show their settings to Administrators. You may need to add a filter or use a plugin like “User Role Editor” to grant access.
  • Not testing after assigning. Always log in as the new role to confirm they can’t see admin-only menus.

Tips

  • Start minimal. Give only the capabilities needed. You can always add more later.
  • Use a plugin that integrates with your SEO plugin. Some SEO plugins (like Rank Math) have built-in role manager. Check your SEO plugin’s settings first.
  • Create a separate role for “SEO Manager” if needed. Some plugins have predefined roles like that. You can use those instead of building from scratch.
  • Document the capabilities you assign. Write them down so you can replicate the role on another site.

Troubleshooting

  • SEO plugin options are not visible to the SEO Editor. This is common with Yoast SEO. Go to Yoast SEO → Settings → Roles & Permissions and check the boxes for the SEO Editor role. If that doesn’t work, add a code snippet to your theme’s functions.php file: add_filter('wpseo_manage_options', function($cap) { $cap = 'seo_editor'; return $cap; }); (adjust the capability name to match your role).
  • User Role Editor doesn’t show SEO plugin capabilities. Some plugins register capabilities dynamically. Try refreshing the page or deactivating/reactivating the SEO plugin. If still missing, use the “Add Capability” button in User Role Editor and type the capability manually (e.g., wpseo_manage_options).
  • The role doesn’t appear in the user edit screen. Make sure you saved the role and that you’re looking at the correct user. Also check that you didn’t accidentally delete the role.
  • Changes not taking effect. Clear any caching plugins (like W3 Total Cache or WP Super Cache) and also clear your browser cache.

Frequently Asked Questions

Can I create an SEO Editor role without a plugin?

Yes, you can add code to your theme’s functions.php file using the add_role() function. However, using a plugin is safer and easier to manage.

What’s the difference between Editor and SEO Editor?

An Editor can publish and manage all posts and pages. An SEO Editor typically has the same editing abilities but also has access to SEO plugin settings, without being able to change site-wide settings like themes or plugins.

Will the SEO Editor be able to delete posts?

If you copy from the Editor role, yes, they can delete posts and pages. If you want to prevent deletion, remove the delete_posts and delete_pages capabilities from the role.

Does Yoast SEO have its own SEO Editor role?

Yes, Yoast SEO includes “SEO Manager” and “SEO Editor” roles. You can assign those directly, but they don’t have full editing capabilities. You can combine them with the Editor role by adding the Editor capabilities to the SEO Editor role.

Can I give the SEO Editor access to only certain SEO plugins?

Yes, you control which capabilities are granted. For example, you can give wpseo_manage_options but not rank_math_manage_options.

What if I accidentally remove all capabilities from my own admin account?

If you lock yourself out, use FTP or your hosting file manager to access the site. Open wp-config.php and add define('WP_DEBUG', true); (not needed) – actually, you can use a plugin like “WP Reset” or manually edit the database. The safest method is to use a plugin like “User Role Editor” from the WordPress admin, but if you can’t log in, you can use phpMyAdmin to change your user role in the wp_usermeta table.

Related

Method: the standard formula for this calculation, rounded as each result states. See how the calculators work or report an error.