[[user-roles]]
=== Changing a User's Roles

[role="summary"]
How to change or add roles for a user.

(((User role,changing)))
(((Role,changing)))
(((Permission,changing role)))

==== Goal

Change or add roles to a given user, either by editing a single-user or by
applying a bulk operation.

==== Prerequisite knowledge

<<user-concept>>

==== Site prerequisites

The user account that you want to update, and the role you want it to have, must
already exist. See <<user-new-user>>,  <<user-new-role>>, and
<<user-permissions>>.

==== Steps

===== Updating the roles using single-user editing method

. In the _Manage_ administrative menu, navigate to _People_
(_admin/people_).

. Locate the user 1 account (named "admin") to assign it the _Administrator_
role. If it is not immediately visible, use the _Name or email contains_ filter,
or other filters, to narrow down the list.

.  Click _Edit_ to update the user account.
+
--
// People page (admin/people), with user 1's Edit button outlined.
image:images/user-roles_people-list.png["People page",width="100%"]
--

.  On the _Edit_ page, scroll down to _Roles_ section. Check the _Administrator_
role for the user account.
+
--
// Roles area on user editing page.
image:images/user-roles_person-edit.png["Roles section of user edit page",width="141px"]
--

.  Click _Save_ to update the user account. You should be returned to the
_People_ page and see a message saying that the changes have been saved.
+
--
// Confirmation message after updating user.
image:images/user-roles_message.png["Confirmation message"]
--

===== Updating the roles using bulk editing method

. If the users Happy Farm and Sweet Honey did not already have the Vendor role,
here is how you would add it. In the _Manage_ administrative menu, navigate to
_People_ (_admin/people_).

. Locate Vendor user accounts  _Sweet Honey_ and _Happy Farm_ and check them. If
they are not immediately visible, use the _Name or email contains_ filter, or
other filters, to narrow down the list.

. Select _Add the Vendor role to the selected user(s)_ from the _Action_
select list.
+
--
// Bulk editing form on People page (admin/people).
image:images/user-roles_bulk.png["People page with bulk operation set up", width="100%"]
--

. Click _Apply to selected items_. You should see a message indicating that the
desired changes were made.
+
--
// Confirmation message after bulk user update.
image:images/user-roles_message_bulk.png["Confirmation message"]
--

// ==== Expand your understanding

// ==== Related concepts

==== Videos

// Video from Drupalize.Me.
video::https://www.youtube-nocookie.com/embed/hd7Sr3-n9ME[title="Changing a User's Roles"]

// ==== Additional resources


*Attributions*

Written by https://www.drupal.org/u/chris-dart[Chris Dart]
and https://www.drupal.org/u/jhodgdon[Jennifer Hodgdon]
