1. Docs
  2. Administration
  3. Company settings
  4. Users

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.

4 min read Updated CustomersAdmins

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#

ColumnWhat it showsWho can change it
UserName and email.—
RoleADMIN or USER. SmartestQA operators show a red SUPER ADMIN chip.Admins, not for themselves or the last admin
ActiveWhether the user can sign in.Admins, not for themselves or the last admin
Password ConfirmTicked when the user has set a password (or signed in with Active Directory).Only SmartestQA
Api KeyThe API key of the user’s own agent host (eight dots and the last 4 characters), with a copy icon.—
ProjectsA + that opens Assign Projects. Greyed out for admins: “Admin users have access to all projects.”Admins
ActionsSend 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.

  • 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.
  • Already created but never set a password? Creating the same email again resends the link.
  • With Active Directory, 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. 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 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? 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 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.

If something goes wrong#

Didn’t find your answer?Write to support with your project name and what you see on screen.

info@smartestqa.ai