Home » Classes » WP_Roles

The WP_Roles class in WordPress is responsible for creating, managing and editing user roles and capabilities for the WordPress website. This class is a part of the WordPress Core and provides a structured way of defining and managing user roles and permissions.

Using the WP_Roles class, developers can create custom roles with customized permissions, add/remove capabilities to existing roles and define which roles are allowed to perform certain tasks within the website. WP_Roles is also used to set the default role for new users that register on the site.

The class provides several methods for manipulating user roles and capabilities such as add_role(), remove_role(), add_cap(), remove_cap() and more. These methods allow developers to easily add, remove, and modify roles and capabilities for users.

Here is an example usage code for adding a new custom role:

// Create a new role
add_role( 'editorial', 'Editorial', array(
  'read' => true,
  'edit_posts' => true,
  'delete_posts' => true,

In the above example, we are creating a new role called ‘editorial’ with the display name ‘Editorial’. The array defines which capabilities this role has. In this case, the role can read, edit and delete posts.

In summary, the WP_Roles class is an essential tool for WordPress developers to manage user roles and permissions. It allows for customization of user roles, which ensures that the right users have access to the right features on the website.

Learn More on WordPress.org

WordPress snippets using the WP_Roles class

Register an account to save your snippets or go Pro to get more features.