# Manage roles and permissions

Control what each team member can see and do in your admin panel by setting up roles.

Audience: dealer-managers
Availability: available
Canonical source: https://rooftoprv.com/docs/manage-roles-and-permissions

A role is a set of permissions. Every team member has one role. The role decides which parts of the admin panel they can open and change.

## Before you start

- You need the **Manage permissions** permission to open **User roles** and to change any role.
- You also need **View team**, which opens the **Admin** section.
- To give a role to a team member, you need the **Assign roles** permission.

## Create a role

1. Go to **Admin** > **Organization** > **User roles**.
   The **Roles and permissions** page lists every role. Each one shows how many permissions it has and how many members use it.
2. Select **Create role**.
   The **Create role** panel opens.
3. Enter a **Role name**, such as Sales Manager.
   The **Slug** fills in from the name. Each role needs its own slug. You can't change it after you create the role.
4. Optional: enter a **Description**.
5. Optional: choose a **Badge color**.
6. Under **Permissions**, check each permission the role should have.
   A new role starts with nothing checked.
7. Select **Create role**.
   The role appears in the list.

Permissions are grouped by area, such as **Leads**, **Inventory**, and **Team**. The count next to each group shows how many are on. Select **Select all** to check a whole group, or **Clear all** to uncheck it.

Each permission has a short description under its label. Read it before you check the box. Some areas have a view permission and separate permissions for editing or deleting. That lets a role look without changing anything.

## Change what a role can do

1. Go to **Admin** > **Organization** > **User roles**.
2. On the role, select the **Edit** button.
   A panel named **Edit:** and the role name opens.
3. Check or uncheck permissions.
4. Select **Save changes**.

Roles marked **System** come with your site. You can change their permissions, description, and badge color. You can't change their name or delete them.

## Hide inventory statuses from a role

By default a role sees RVs in every status. You can hide statuses a role doesn't need, such as RVs that are still being prepared.

1. Open the role's **Edit** panel.
2. Under **Visible inventory statuses**, uncheck each status to hide.
   The statuses are grouped under **Pipeline** and **Listing**.
3. Select **Save changes**.
   The role's card shows how many statuses are hidden.

People with that role no longer see RVs in a hidden status in inventory lists, the board, selectors, or search.

## Copy a role

Copying is the fastest way to make a role that differs from another by a few permissions.

1. On the role, select the **Duplicate** button.
2. Optional: change the **New role name**.
3. Optional: change the **Slug**.
4. Select **Duplicate**.

The copy keeps the original's permissions and badge color. Its description starts with "Copy of" and the original role's name. A copy of a **System** role is a regular role you can rename and delete.

The copy doesn't keep hidden inventory statuses. Set those again on the copy.

## Give a role to a team member

1. Go to **Admin** > **Organization** > **Team**.
2. Select the **Edit** button next to the team member.
3. Select the **Role** tab.
4. Select the role you want.
5. Select **Save changes**.

You choose a role for a new person when you invite them. See [Invite team members](https://rooftoprv.com/docs/invite-team-members).

## Mark a default role

Nothing gives the default role to anyone automatically. The invite form doesn't fill it in. You still choose a role for each person you invite.

1. On the role, select the **Set as default** button.
   The role gets the **Default** badge. The **Default role** box at the top of the page shows its name. The confirmation says the role is now the default for new members.

Only one role can be the default.

## Delete a role

> **Warning:** Deleting a role can't be undone.

1. Make sure no one has the role. Give its members another role first.
2. On the role, select the **Delete** button.
3. Confirm the prompt that asks whether to delete the role.

Roles marked **System** have no **Delete** button.

## Troubleshooting

**I get "Cannot delete role"**
The role still has members. The message says how many. Give each of them another role on the **Team** page, then delete the role.

**Creating or copying a role shows an error**
Another role may already use the same slug. Change the **Slug** and try again.

**I can't see User roles**
Ask someone who manages your team's roles for the **Manage permissions** permission.

**A team member can't see some RVs**
Their role may hide those statuses. Open the role and check **Visible inventory statuses**.

## Related guides

- [Invite team members](https://rooftoprv.com/docs/invite-team-members)
