Users

In order for a person to log into the Uniform Dashboard, the person must have a user account.

About users#

Team admin#

Team admins have elevated permissions that allow them to manage all aspects of the team. Only team admins can:

• Modify team settings and configuration
• Create and delete projects
• Invite and remove team members
• Create and manage roles
• Generate and manage API keys
• Install and manage custom integrations

Common tasks#

Create user#

You create a new user by inviting the person to Uniform.

1. In Uniform, navigate to Security > Users.

2. Click Invite member.

3. Enter the user's name and email address.

4. If you want the user to be an administrator, tick the box Team Admin.

5. In the section Assign projects & roles, find the project you want the user to have access to.

6. Select the roles you want to assign.

   info

   You can assign multiple roles, permissions within the roles are additive for the user.

7. Click Send Invitation.

8. In the section Outstanding Invitations, you will see the user you invited.

   About this step

   An email is sent to the user. When the user clicks the link in the email, if they aren't already logged in, they're invited to login or create an account. After they do this, they're asked if they want to join the team. If they join the team, they will have the access you specified.

   info

   Invitations are valid for 7 days. Unclaimed invitations are removed automatically 30 days after they're sent.

   tip

   If you decide you don't want the user to have access to your team, you can click Revoke to invalidate the invitation, preventing the user from accepting the invitation and gaining access to your Uniform team. If the user has already joined the team, you can remove the user from your team.

Remove a user from your team#

Removing a user takes away their access to your Uniform team and revokes the personal access tokens they created for it. Their Uniform account and their memberships in other teams stay in place. To erase an account entirely, the user has to delete their own account. If the user signs in with SSO and this is their last team, removing them erases the account.

1. In Uniform, navigate to Security > Users.
2. Click the name of the user you want to remove.
3. Click delete.
4. Click OK.

Update user#

Editing a user enables you to change the projects and permissions for the user.

1. In Uniform, navigate to Security > Users.
2. Click the name of the user you want to edit.
3. In the Assign projects & roles section:
   • To add access to a project, find the project and select one or more roles from the dropdown.
   • To change roles on a project, use the dropdown to select or deselect roles.
   • To remove access from a project, click the x next to each assigned role.
4. Click Save.

Delete your account#

Any user can permanently delete their own Uniform account; you don't need to be a team admin. This erases your account and personal data across every Uniform team you belong to.

1. In Uniform, navigate to Security > Users.

2. Click your own name in the list.

3. Click Delete my account.

4. Type your email address to confirm.

5. Click Permanently delete my account.

   About this step

   Your account is deleted and you're signed out of Uniform.

What's deleted and what stays#

Deleting your account removes:

• Your Uniform account and login
• Your memberships and roles in every team
• The personal access tokens you created
• Every team where you're the only member, along with everything that team contains

Teams you share with other people are kept. The content you created in those teams stays, but it's no longer attributed to you.

When you can't delete your account#

Uniform checks every team you belong to before it deletes anything. If one of these checks fails, nothing is deleted and the dashboard shows the reason:

• You're the only team admin of a team that has other members (not counting service accounts, personal access tokens, or automations). Make another member a team admin first.
• A team where you're the only member has an active paid subscription. Cancel the subscription first.

Enable single sign-on#

Users can log into Uniform using their email address, or their Google or GitHub credentials. If your organization uses another service for single sign-on (e.g. Auth0, Microsoft Entra ID/Azure Active Directory, etc.), see SSO integration for details.