[[user-new-role]]

=== Creating a Role

[role="summary"]
How to create a new role.

(((User role,creating)))
(((Role,creating)))
(((Role,anonymous user)))
(((Role,authenticated user)))
(((Role,administrator)))

==== Goal

Create a Vendor role to allow some - but not all - users to perform specific
tasks.

==== Was man wissen sollte

<<user-concept>>

// ==== Site prerequisites

==== Steps

. In the _Manage_ administrative menu, navigate to _People_ > _Roles_
(_admin/people/roles_).

. You will find default roles _Anonymous user_,
_Authenticated user_, and _Administrator_ already present.
+
--
// Roles page (admin/people/roles).
image:images/user-new-role-roles-page.png["Roles page"]
--

. Click _Add Role_ to add a custom role.

. Type Vendor in the _Role name_ field. Click _Save_.
+
--
// Add role page (admin/people/roles/add).
image:images/user-new-role-add-role.png["adding vendor as a role"]
--

. You will see the message "Role Vendor has been added." displayed at the top
of the page.
+
--
// Confirmation message after adding new role.
image:images/user-new-role-confirm.png["vendor role added success message"]
--

==== Expand your understanding

* <<user-permissions>>
* <<user-roles>>

//==== Related concepts

==== Additional resources

https://www.drupal.org/node/1803614[_Drupal.org_ community documentation page "User Roles"]


*Attributions*


Adapted and edited by https://www.drupal.org/u/JackProbst[Jack Probst],
https://www.drupal.org/u/batigolix[Boris Doesborg], and
https://www.drupal.org/u/eojthebrave[Joe Shindelar] from
https://www.drupal.org/node/1803614["User Roles"], copyright 2000-2017 by the
individual contributors to the https://www.drupal.org/documentation[Drupal
Community Documentation]
