Team and permissions
Manage roles and permissions
Control what each team member can see and do in your admin panel by setting up roles.
For: Dealer managers
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
- 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.
- Select Create role. The Create role panel opens.
- 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.
- Optional: enter a Description.
- Optional: choose a Badge color.
- Under Permissions, check each permission the role should have. A new role starts with nothing checked.
- 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
- Go to Admin > Organization > User roles.
- On the role, select the Edit button. A panel named Edit: and the role name opens.
- Check or uncheck permissions.
- 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.
- Open the role's Edit panel.
- Under Visible inventory statuses, uncheck each status to hide. The statuses are grouped under Pipeline and Listing.
- 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.
- On the role, select the Duplicate button.
- Optional: change the New role name.
- Optional: change the Slug.
- 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
- Go to Admin > Organization > Team.
- Select the Edit button next to the team member.
- Select the Role tab.
- Select the role you want.
- Select Save changes.
You choose a role for a new person when you invite them. See 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.
- 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.
- Make sure no one has the role. Give its members another role first.
- On the role, select the Delete button.
- 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.