directus/docs/configuration/users-roles-permissions/users.md

description, readTime

description	readTime
Users represent the distinct people and entities that interact with your project.

Users

Users represent the distinct people (and entities) that interact with your project. Each user can be assigned a role, which defines a user's access permissions.

:::tip Learn More

To configure users programmatically, see our API documentation on users.

:::

Within the Data Studio, the User Directory is the primary place to manage users. However, certain controls are included in Settings > Roles & Permissions > [Role] as well, which is what the following sections will focus on.

Invite a User

To invite people to become users via email and automatically assign them a role in the process, follow these steps.

1. Navigate to Settings > Roles & Permissions > [Role].
2. Click person_add in the page header.
3. Enter one or more email addresses, separated by a comma and a space.
4. Click Invite to confirm.

:::tip

Instead of comma-separated emails, you can also add new emails line-by-line.

:::

Create a User

To create a user and assign their role (and other details) follow these steps.

1. Navigate to Settings > Roles & Permissions > [Role].
2. Under the Users in Role section, click Create New and a drawer will open.
3. Fill in the user's details as desired. The newly created user will now be visible under Users in Role.
4. Click check in the page header to confirm and the drawer will close.

Assign Role to Existing User

To assign a role to an existing user, follow these steps.

1. Navigate to Settings > Roles & Permissions > [Role].
2. Under the Users in Role section, click Add Existing and a drawer will open.
3. Select users as desired.
4. Click check to confirm and the drawer will close. The added user(s) will now be visible under Users in Role.
5. Click check in the page header to confirm.

Remove User's Role

To remove a user from a role, follow these steps.

1. Under the Users in Role section, click close and the user will be removed from the role.
2. Click check in the page header to confirm.

The user(s) now have a NULL role, public permissions, until assigned a new role.