Custom Access Roles


NEW IN VERSION 2.0.0: Users with a custom role will now only see the posts or pages they are assigned to. We’ve also streamlined the admin interface for easier configuration, and included additional instructions to help you get the proper capabilities assigned to your custom roles.

Custom Access Roles allows you to create, edit and delete custom roles for editing content. It was created to fill a need for a role editor plugin that is focused on providing easy-to-use admin tools for restricting content editing access. It is not concerned with restricting viewing access on the front end.

It is specifically intended for large sites with multiple content editors, where editors (by role, not individually) need to be restricted to only being able to edit specific areas of the site.

With this plugin, administrators of large sites have relatively fine-grained control over which user roles can edit which content, making it possible to manage a team of editors without concern that they will (accidentally or deliberately) edit content they should not have access to.

You can define a fully customized set of capabilities for each role, along with defining a specific set of post categories, pages, and custom post types to which those capabilities apply. For all other content, the role will have read-only access.

Custom Access Roles provides an easy interface for managing these roles and capabilities, with checkboxes for each capability grouped by the standard roles they’re associated with, plus checkboxes for each post category, page, and custom post type, presented in an organized hierarchy.


  • The first screen of the plugin admin. You can edit an existing custom role, create a new one, or delete an existing one. By default the plugin allows you to delete existing roles even if there are users assigned to them, although core WordPress roles and certain popular third-party plugin roles are restricted. You can change this by modifying a variable in the plugin source code. A future update will allow admins to change this setting without modifying code.

  • The screen where role capabilities and content access are set. Pages and Categories are listed in hierarchical order, with checkboxes to select which ones for which the role will have the assigned capabilities. For all others, the role will have read-only access.

  • You can find the settings for the plugin under Custom Access Roles in the Users menu.


  1. Upload the plugin files to the /wp-content/plugins/ directory.
  2. Activate the plugin through the ‘Plugins’ menu in WordPress.
  3. Go to Users > Custom Access Roles to manage roles and capabilities.


How do I grant access to Custom Post Types?

If your CPT has its own capabilities, assign those capabilities to the role. Otherwise, CPTs use the same permissions as Posts. Assign edit_posts and all similar edit_*_posts capabilities. Note that this will give these users the ability to edit Posts as well, but only for the specific categories they’ve been given access to using this plugin. This is why “publish_posts” is not enabled by default.

Users who should only be able to edit Posts see the Pages section, and vice versa

The default capabilities set by the plugin assume basic editing capability for both Pages and Posts. If you are creating a role that should only be able to edit Pages, under the Capabilities tab (when configuring the role) uncheck all capabilities containing the word “posts”. Likewise, for roles who will only be editing Posts, uncheck all capabilities containing the word “pages”.

Capabilities for CPTs are a bit more complicated, because some CPTs have their own custom capabilities, while others do not, and default to using the “posts” capabilities. You’ll need to inspect the configuration of the CPT to determine which capabilities are used.

How do I set up an order fulfillment role for WooCommerce?

The “Shop Manager” user role in WooCommerce may have more capabilities than you would like, such as the ability to edit Posts, Pages and Products. It is possible to set up a fulfillment role that is focused mainly on WooCommerce orders, with no access to edit content. Unfortunately because of how the capabilities in WooCommerce are grouped, this role will still have the capability to edit all of the WooCommerce Settings.

  1. Create a new custom role, and under the Capabilities tab, uncheck all of the standard capabilities except “read” (under Subscriber).

  2. Still under Capabilities, scroll down to Custom, and check the boxes for all capabilities that contain the words “shop order(s)”. Also check all of the “read” capabilities that include “product(s)”, “shop coupon(s)”, and “shop webhook(s)”.

  3. Also check the box for “manage woocommerce”. This grants more permissions than we would like, but is necessary to grant any access to the WooCommerce admin pages, including Orders.

  4. Optionally, check “view woocommerce reports” if the user should be allowed to view reports.

  5. Under the Content Access tab, scroll down to Custom Post Types and check “Orders”, “Refunds” and “Coupons”.

  6. Click Save Changes. This role is now ready to use.


July 10, 2024
nice plugin thanks I almost going to code it myself but luckly found this 👍
Read all 1 review

Contributors & Developers

“Custom Access Roles” is open source software. The following people have contributed to this plugin.


Translate “Custom Access Roles” into your language.

Interested in development?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.

Changelog – 2023.10.25

  • Fixed fatal error on admin page in WordPress 6.4 (and possibly earlier versions) with PHP 8.1 (and possibly earlier versions), caused by incorrect type casting of two array variables’ initial values as empty strings.


  • Updated logo and icon assets.
  • Updated “Tested up to” to 5.8.1.

  • Added conditional to prevent undefined index notices.


  • Tested with WordPress 5.0.3.
  • Updated admin screen.


  • Added ability to assign access to private Custom Post Types, e.g. the “shop_order” post type in WooCommerce. Instructions for setting up a WooCommerce order fulfillment role have been added to the FAQ page.


  • Pages and Posts lists now only show items the user can actually edit.
  • Improved Custom Access Roles configuration interface.
  • Updated FAQ.

  • Updated FAQ.

  • Updated “Tested up to” to 4.7.


  • Minor code cleanup.


  • Fixed “Can’t use method return value in write context” fatal error for PHP versions before 5.5.


  • Removed anonymous function that was causing errors in PHP versions before 5.3.0.


  • Fixed bug in output logic of CARoles::get_current_user_role() method.


  • Tested against WordPress 4.6.
  • Advanced to official 1.0 release.


  • General file cleanup.


  • Added banner image for WordPress Plugin Directory.
  • Modified plugin description for clarity of purpose.


  • Added PHPDoc-format comments to all class methods.


  • Original version.