---
title: "Users"
section: "Company settings"
description: "SmartestQA Company Settings › Users: create users, change Admin or User role, deactivate and reactivate, assign projects, resend the password setup email."
url: https://docs.smartestqa.ai/en/company-settings-users.html
audience: [customer, admin]
updated: 2026-11-08
keywords: "users user management new user create user invite role admin user deactivate reactivate active project access assign projects password setup email reset api key corporate email licence seat"
---
# Company settings: Users

Users lists everyone in your company. Admins add people here, set their role, switch them off when they leave and choose the projects each User can open.

## In short

**On this page you can**

- Create a user; SmartestQA emails them a link to set their password.
- Change a user’s role between ADMIN and USER .
- Deactivate a user: they are signed out at once and cannot sign in again.
- Choose which projects a User can open.
- Resend the password setup email and copy a user’s agent API key.

**How to use it**

1. Open Configuration › Company Settings › Users .
2. Click New User , fill name, email and role, click Create .
3. Click the + in the Projects column, tick projects in Assign Projects , click Save .
4. Change a role or the Active box in the table, then click Save Changes .
5. If someone did not get the email, use Send password reset email on their row.

## The users table

| Column | What it shows | Who can change it |
| --- | --- | --- |
| **User** | Name and email. | — |
| **Role** | **ADMIN** or **USER**. SmartestQA operators show a red **SUPER ADMIN** chip. | Admins, not for themselves or the last admin |
| **Active** | Whether the user can sign in. | Admins, not for themselves or the last admin |
| **Password Confirm** | Ticked when the user has set a password (or signed in with Active Directory). | Only SmartestQA |
| **Api Key** | The API key of the user’s own agent host (eight dots and the last 4 characters), with a copy icon. | — |
| **Projects** | A **+** that opens **Assign Projects**. Greyed out for admins: “Admin users have access to all projects.” | Admins |
| **Actions** | **Send password reset email**. | Admins |

Search matches first name, last name and email. Show 5, 10, 25 or 50 rows per page. Row actions appear on hover and on keyboard focus.

## Add a user

1. **Click New User**

   The **Create User** dialog opens: “You can create a new user within your own company.”
2. **Fill the form**

   **First Name** and **Last Name** (at least 3 letters, letters only), **E-mail** and **User Role**. **Create** stays greyed out until all four are filled.
3. **Create**

   SmartestQA checks the email and your licence, then sends the new user a password setup link.

   “A password setup link has been sent to:” and the address. The user appears in the table. Ask them to check the spam folder if the email does not arrive.
4. **Give projects (User role)**

   A new User sees no project until you assign one; see [Project access](https://docs.smartestqa.ai/en/company-settings-users.html#project-access).

- **Corporate email only.** Addresses at public webmail services such as gmail.com, outlook.com, hotmail.com, yahoo.com, icloud.com or proton.me are refused: “The email must be a corporate email.”
- **One account per email** across SmartestQA. An address used in another company is refused.
- **Each user created counts** against your licence’s user limit, and deactivating does not take it back. An Admin sees the limit in [Billing › License Details](https://docs.smartestqa.ai/en/company-settings-billing.html#licence-details).
- **Already created but never set a password?** Creating the same email again resends the link.
- With [Active Directory](https://docs.smartestqa.ai/en/company-settings-active-directory.html), you do not need to create AD users: they are created on first sign-in.

## Change a role

1. **Pick the new role**

   Choose **ADMIN** or **USER** in the row’s **Role** list.
2. **Save**

   Click **Save Changes** above the table. It saves every row you changed.

   “Users updated successfully”, and the table reloads with the saved values.

You cannot change your own role (“You cannot change your own role.”), demote the last active admin (“Cannot change the role of the last admin in the company.”), or change a Super Admin. What each role can do: [Roles & permissions](https://docs.smartestqa.ai/en/company-settings-roles.html#matrix). For users who sign in with Active Directory, the role is set again from their AD groups at every sign-in.

## Deactivate or reactivate a user

Untick **Active** and click **Save Changes**. When saved:

- the user cannot sign in, and all their open sessions end at once;
- their own agent host (the **Localhost** entry named after their email) is removed and shows offline;
- their test cases, runs and history stay; nothing is deleted.

Tick **Active** again to reactivate: the user can sign in and their agent host comes back (offline until [the agent](https://docs.smartestqa.ai/en/agent-pool-agents.html) reconnects). Reactivating does not count as a new user.

You cannot deactivate yourself (“You cannot change your own active status”), the last active admin (“Cannot deactivate the last admin in the company.”), or the last active user. Deleting users is done by SmartestQA only.

## Give project access

1. **Open Assign Projects**

   Click the **+** in the user’s **Projects** column (“Manage project permissions”).
2. **Tick the projects**

   Use **Search projects...** to filter, then tick **Assign** for each project. Untick to take access away.
3. **Save**

   Click **Save**.

   “Project permissions updated.” The projects appear in the user’s project list.

A User with no project sees “No Project Access”. Admins always see every project of the company. Access is all or nothing: there is no read-only project access. For Active Directory users, projects from their AD groups are added and removed at every sign-in; projects you assign here by hand are kept.

## Password setup email

**Send password reset email** (lock icon on the row) sends the user a new link to set their password. Use it when the first email was lost or the link expired.

- Not for yourself (“You cannot send a password email to yourself”); use [**Forgot Password?**](https://docs.smartestqa.ai/en/quick-start-troubleshooting.html#fix-link-expired) on the sign-in page.
- Not for inactive users: “User is inactive. Please activate the user and save changes first, then resend the email.”
- While an earlier link is still valid: “A password setup email has already been sent. Please check the inbox”.

Success: “Password reset email has been sent.” and the address.

## Agent API key

Each user has [an agent](https://docs.smartestqa.ai/en/agent-pool-agents.html) host of their own under **Localhost** in Device Farm › Test Agents, with its own API key. The **Api Key** column shows the key masked; the copy icon copies it whole, for example to help a colleague set up their agent. How the key is used: [Install an agent](https://docs.smartestqa.ai/en/quick-start-connect.html#install-agent).

## If something goes wrong

- [“The email must be a corporate email.”](https://docs.smartestqa.ai/en/company-settings-troubleshooting.html#fix-corporate-email)
- [“Company license limit has been reached…”](https://docs.smartestqa.ai/en/company-settings-troubleshooting.html#fix-user-limit)
- [“This email is already in use…”](https://docs.smartestqa.ai/en/company-settings-troubleshooting.html#fix-email-in-use)
- [I can’t change or deactivate an admin](https://docs.smartestqa.ai/en/company-settings-troubleshooting.html#fix-last-admin)
- [A new user got no email](https://docs.smartestqa.ai/en/company-settings-troubleshooting.html#fix-no-email-received)
