Skip to content
Return to top
On this page

# 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.

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.