function add_role( $role, $display_name, $capabilities = array() {}

Add role, if it does not exist.


  • string $role: Role name.
  • string $display_name: Display name for role.
  • array $capabilities: List of capabilities, e.g. array( ‘edit_posts’ => true, ‘delete_posts’ => false );

Return values

returns:WP_Role object if role is added, null if already exists.

Source code

function add_role( $role, $display_name, $capabilities = array() ) {

	global $wp_roles;

	if ( ! isset( $wp_roles ) )

		$wp_roles = new WP_Roles();

	return $wp_roles->add_role( $role, $display_name, $capabilities );



No comments yet... Be the first to leave a reply!

Leave a Reply

Fill in your details below or click an icon to log in: Logo

You are commenting using your account. Log Out /  Change )

Facebook photo

You are commenting using your Facebook account. Log Out /  Change )

Connecting to %s

%d bloggers like this: