# Users and roles: create and edit roles

Create a role for a job, give it permissions, rename it, give it to people and delete it.

A role is a set of permissions for one kind of job, such as Office, Crew lead or Estimator. Make it once, give it what the job needs, and hand it to everyone who does that job. This article covers the whole life of a role: creating it, giving it permissions, changing it and deleting it.

[Open Roles now](/tenant/?open=settings/users-roles)

## Create a role

1. Open **System settings**, then **Users and roles**, and click the **Roles** tab.
   ![Open the Roles tab](files/51775d65-1ae1-4eda-b2ac-0daafa94c11d/create-and-manage-roles-20261108-001237.webm#t=3.8,15.6)
2. Click **+ New role**.
   ![New role](files/51775d65-1ae1-4eda-b2ac-0daafa94c11d/create-and-manage-roles-20261108-001237.webm#t=15.9,19.0)
3. Type the job in **Name** (for example *Shift supervisor*) and say what the role is for in **Description**. Each role in your workspace needs its own name.
   ![Name and description](files/51775d65-1ae1-4eda-b2ac-0daafa94c11d/create-and-manage-roles-20261108-001237.webm#t=19.2,33.6)
4. Click **Create role**. The role opens on its **Permissions** tab, with nothing assigned yet.
   ![Create role](files/51775d65-1ae1-4eda-b2ac-0daafa94c11d/create-and-manage-roles-20261108-001237.webm#t=33.5,35.4)

## Give the role its permissions

1. On the **Permissions** tab, the left side, **Available permissions**, lists every module's permissions. Open a module, or type in **Search permissions** to find one.
   ![Open the role's permissions and search](files/51775d65-1ae1-4eda-b2ac-0daafa94c11d/create-and-manage-roles-20261108-001237.webm#t=37.9,48.3)
2. Click **Add to role** on each permission the job needs, or **Add all** to take everything a module offers. The right side, **Assigned permissions**, shows what the role will hold.
   ![Add to role: not saved yet](files/51775d65-1ae1-4eda-b2ac-0daafa94c11d/create-and-manage-roles-20261108-001237.webm#t=49.7,53.4)
3. Click **Save changes**. Until you do, the line above the lists says what will be added and removed, and **Undo changes** puts everything back.
   ![Save changes](files/51775d65-1ae1-4eda-b2ac-0daafa94c11d/create-and-manage-roles-20261108-001237.webm#t=53.3,56.0)

Everyone who holds the role gets the change as soon as you save.

> **Tip: read the labels before you add.** **Take care**, **High risk** and **Critical** mark permissions that change or delete a lot, or reach sensitive information. **Their own records only**, **Their team only** and **Their site only** say whose records a permission reaches. **Also gives** means a permission includes another one: *edit* includes *read*.

## Rename a role or change its description

1. Click the role's card, then the **Details** tab, then **Edit**. (The card has an **Edit** button too.)
   ![Details, then Edit](files/51775d65-1ae1-4eda-b2ac-0daafa94c11d/create-and-manage-roles-20261108-001237.webm#t=58.3,64.9)
2. Change the **Name** or **Description**, then click **Save**.

The **Admin** role keeps its name, but you can change its description.

## Give the role to people

1. Click the role's card, then the **Members** tab.
   ![The Members tab](files/51775d65-1ae1-4eda-b2ac-0daafa94c11d/create-and-manage-roles-20261108-001237.webm#t=64.8,67.8)
2. Pick the person in **Select user…** and click **Assign**.
   ![Select user, then Assign](files/51775d65-1ae1-4eda-b2ac-0daafa94c11d/create-and-manage-roles-20261108-001237.webm#t=67.7,71.9)

To take the role away from someone, click **Remove** next to their name. You can also give roles from a person's own panel under **Users**: see *Add and manage people*.

## Delete a role

A role can only be deleted once nobody holds it. That's on purpose: permissions come only from roles, so deleting a role that someone still holds would leave them signed in with nothing they can do.

1. Click the role's card, then the **Members** tab, and give each person their new role from their own panel under **Users**.
2. Back on **Members**, click **Remove** next to each person until the list is empty.
3. Click the **Details** tab, then **Delete role**, and confirm. (The card has a **Delete** button too.)
   ![Delete role](files/51775d65-1ae1-4eda-b2ac-0daafa94c11d/create-and-manage-roles-20261108-001237.webm#t=72.1,75.6)

If anyone still holds the role, the platform doesn't delete it. It lists who holds it and offers **Open Members tab** so you can move them first.

The **Admin** role can't be deleted. It's the system role for your Workspace Administrators.

## Check your work

Open someone who holds the role under **Users** and press **Simulate** to see the workspace exactly as they do. See *Simulate a user*.

[Show me how](showme:platform-create-a-role)


Source: https://datavisions.ai/docs/system-settings/people/users-and-roles-create-and-edit-roles
