Summery Summery

Add role, if it does not exist.

Syntax Syntax

add_role( string $role, string $display_name, array $capabilities = array() )

Parameters Parameters


(string) (Required) Role name.


(string) (Required) Display name for role.


(array) (Optional) List of capabilities, e.g. array( 'edit_posts' => true, 'delete_posts' => false );

Default value: array()

Return Return

(WP_Role|null) WP_Role object if role is added, null if already exists.

Source Source

File: wp-includes/capabilities.php

 * @param string      $capability Capability name.
 * @param mixed       ...$args    Optional further parameters, typically starting with an object ID.
 * @return bool Whether the user has the given capability.
function user_can( $user, $capability, ...$args ) {
	if ( ! is_object( $user ) ) {


Changelog Changelog

Version Description
2.0.0 Introduced.


Leave a Reply

This site uses Akismet to reduce spam. Learn how your comment data is processed.