> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dovetail.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Add, remove and manage users

<img src="https://mintcdn.com/dovetail-e5aa4160/KQAL-sbmnn8I0g9n/help/user-roles/user-roles-hero.png?fit=max&auto=format&n=KQAL-sbmnn8I0g9n&q=85&s=fc61da6640c298cc99391172e297bd52" alt="User Roles Hero Pn" width="2184" height="1452" data-path="help/user-roles/user-roles-hero.png" />

<Info>
  Free and Professional workspaces can invite new users to their workspace. However, user roles are available only on the *legacy* Professional, Business, and Enterprise plans.

  **Admin** access can be granted to any user on any plan.
</Info>

## Add new users to your workspace

<Note>
  All users invited to the most recent Professional plan will occupy a paid seat.
</Note>

### Invite via email

You can invite new users to your workspace from the **Users** settings page.

### Current Professional plans

1. Navigate to [**⚙️ Settings → Users**.](https://dovetail.com/settings/users)
2. Enter the email address of one or more users.
3. Select **Invite users**.

Once invited, the user will receive an email invitation to join your workspace.

***

### Legacy Professional, Business, and Enterprise workspaces

User invitation permissions depend on your role:

* **Admins** can invite users at **any role level**.
* **Non-admin users** can only invite others at a role **equal to or lower than their own**.
  * For example, if you are a **Contributor**, you can invite users as either Contributors or Viewers.

To invite a user:

1. Navigate to **[⚙️ Settings → User](https://dovetail.com/settings/users)s**.
2. Enter the email address of one or more users.
3. Select **Invite users**.

For these workspaces, you will also need to **assign a role** to the user before sending the invite.

***

#### Managing and restricting who invites users

**Workspace admins** on **Business** and **Enterprise** plans with user roles can manage and restrict who invites new users via ⚙️ **[Settings → ](https://dovetail.com/settings/authentication)Security settings.**

**Who can invite new users:**

This allows you to restrict users from inviting other users. Select between "**Admins only**" or "**Anyone**".

**Who can invite users as contributors or managers:**

This allows you to restrict users from distributing paid seats. Select between "**Admins only**" or "**Anyone**".

***

### Manage pending invites

Pending invitations appear at the **top of the Users page**, where you can:

* **Resend** an invitation
* **Revoke** an invitation

<Info>
  **Note:** Invited users who are assigned a role other than **Viewer** will occupy a **paid seat**, even if the invitation has not yet been accepted.
</Info>

<video autoPlay={true} muted={true} loop={true} playsInline={true} className="w-full" src="https://videos.ctfassets.net/8fl1jrx919na/4HPNDYt6Oo6Gi98DThfXO4/795b258ca9c60dc80d911ee8ddf21eeb/Invite_user.mp4" />

<Info>
  A workspace invite remains active 14 days from the date it was created.
</Info>

***

### Managing automatic account creation

Workspace admins can enable **automatic account creation**, allowing users with an approved email domain to join a workspace when they create a Dovetail account. Automatic account creation is enabled by default.

For example, if your organization has approved the domain **@[acme.com](http://acme.com)**, anyone who signs up for Dovetail using an **@[acme.com](http://acme.com)** email address will automatically be added to the workspace as a **Viewer**.

<Info>
  **Note:** Automatic account creation is **not** available on the most current Professional plan. If you see a diamond icon next to this setting in **⚙️**[Settings → Authentication](https://dovetail.com/settings/authentication), this feature is **not** available on your plan, and automatic account creation will be enabled by default.
</Info>

#### Set up automatic account creation

1. If you haven't already, add an approved email domain under **⚙️**[Settings → Authentication](https://dovetail.com/settings/authentication) → **Automatic account creation**
2. Enable or disable **Automatic account creation** by toggling the setting on or off.

Once enabled, any user who creates a Dovetail account with an approved email domain will automatically be granted access to the workspace as a Viewer.

<video autoPlay={true} muted={true} loop={true} playsInline={true} className="w-full" src="https://videos.ctfassets.net/8fl1jrx919na/6lPzjhZVlLbQy8iC8rrGaF/c364fc1ced9d9676809a7667ff73be26/Allowed_domains_viewers.mp4" />

***

## User management

Only admins will be able to manage:

* Users roles
* Deleting or deactivating users
* Granting or revoking admin status

***

## Remove users from your workspace

Workspace admins have two options available if they need to remove a user from the workspace:

* **Deactivate user** → If a user is deactivated, they will no longer have access to the workspace, but their account will still exist in case you wish to reactivate them later. Additionally, deactivated users will continue to appear as authors on their contributions.
* **Delete user** → If a user is deleted, their account will be completely removed and cannot be added back. Their contributions will remain in the workspace, but they will be removed as authors.

<Info>
  **Important for Business and Enterprise plans:**

  If the user being removed is the only person with **Full access** to a folder, project, channel, or other private content, Dovetail will automatically update permissions to ensure the content remains accessible. Full access will be granted to workspace admins who are also managers. If no workspace admins are managers, Full access will be granted to all managers. More information can be found [here](https://docs.dovetail.com/help/access-and-permissions/index#access-private-content-after-a-user-is-removed-from-your-workspace).
</Info>

***

## User roles

In Free and Professional workspaces, all users count toward a paid seat. In Enterprise, Business, and *legacy* Professional workspaces, three roles can be assigned to users: **Viewer**, **Contributor**, and **Manager**.

To update a user role, navigate to **[⚙️ Settings → User](https://dovetail.com/settings/users)s** → Locate the user and click their role drop-down, and select the new role.

| **Role**    | **Description**                                                                                                                                                                                                      |
| :---------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Manager     | Anyone who will be contributing to work as well as managing the workspace, including project settings, workspace-wide tags and fields, should be added as a manager.                                                 |
| Contributor | Anyone conducting research by viewing, contributing to, and analyzing data should be added as a contributor. This is the most common user type for people who are using Dovetail for lightweight or formal research. |
| Viewer      | Anyone who will only be reading research outputs, but not editing any data, should be added as a viewer. Viewers are free to add and unlimited.                                                                      |

Each user role has a different set of permissions.

| Permission                                                      | Viewer | Contributor | Manager |
| :-------------------------------------------------------------- | :----- | :---------- | :------ |
| Can view, comment, and share projects                           | ✔      | ✔           | ✔       |
| Can subscribe to notifications                                  | ✔      | ✔           | ✔       |
| Can use Chat to ask questions and chat with Agents <sup>2</sup> | ✔      | ✔           | ✔       |
| Can contribute data to projects                                 |        | ✔           | ✔       |
| Can create and manage projects                                  |        | ✔           | ✔       |
| Can configure access control <sup>1</sup>                       |        | ✔           | ✔       |
| Can create workspace tags & fields <sup>1</sup>                 |        | ✔           | ✔       |
| Can create templates <sup>1</sup>                               |        |             | ✔       |
| Can add transcription vocabulary <sup>1</sup>                   |        |             | ✔       |
| Can edit home and feeds <sup>1</sup>                            |        |             | ✔       |

1. Available on Enterprise
2. Viewers can start conversations and chat with Agents or digital twins they have access to, but can't create or modify workspace content (e.g., creating docs or Agents) from chat. This always requires a paid seat.

<Info>
  Please note that Viewers are only available on select legacy plans and on our Business and Enterprise plans.
</Info>

***

## Grant admin access to users

Workspace admins can grant admin access to any user in the workspace. Only existing admins can assign or remove admin access.

> **Workspaces that include user roles:** Managers, Contributors, and Viewers can be granted admin access in addition to their workspace role.

Users with admin access can:

* Manage billing and subscriptions
* Deactivate or delete users
* Configure workspace branding
* Manage authentication and security settings
* Delete the workspace

To grant admin access, hover over the user's name, click **•••**, and select **Grant admin access**.

<video autoPlay={true} muted={true} loop={true} playsInline={true} className="w-full" src="https://videos.ctfassets.net/8fl1jrx919na/3Yx2cXpzn8NvlviJ5hWYO9/560d66ef9e51d6146da204baa3a44813/Grant_admin_access.mp4" />

***

# FAQs

<Accordion title="Can Viewer roles apply or edit filters in a project?">
  No, Viewers do not have edit access within the workspace. So, they will not be able to add or edit applied filters within a project. 
</Accordion>
