Adds a role, if it does not exist.

$role string Required

Role name.

$display_name string Required

Display name for role.

$capabilities bool[] Optional

List of capabilities keyed by the capability name, e.g. array( 'edit_posts' => true, 'delete_posts' => false ).

Default: array()

WP_Role|void WP_Role object, if the role is added.

File: wp-includes/capabilities.php. View all references

function add_role( $role, $display_name, $capabilities = array() ) {
	if ( empty( $role ) ) {
		return;
	}

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