add_role() WordPress Function

The add_role() function is used to create new roles for users in a WordPress site. This function takes two parameters: the role name and a capabilities array. The role name is a string that is used to identify the role, while the capabilities array is used to specify the capabilities that the role will have.

add_role( string $role, string $display_name, bool[] $capabilities = array() ) #

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