SquidSupport
Product reference / Settings

Roles

In the app: Settings → Roles

Needs the 'View Team' permission.

A role is a named set of permissions. This page lists every role in your organization and lets you create, copy and delete custom roles. A role is defined once for the organization: its permissions go with the person who holds it to every store they can see. Who holds which role is set under Settings → Team.

Role list

The table shows every role, sorted by type ("System" first, then "Predefined", then "Custom") and by name inside each type.

  • "Name": the role's name, with its description underneath. Click the name to open the role and see exactly which permissions it holds. A padlock marks a system role, a shield a predefined role.
  • "Type": "System", "Predefined" or "Custom". See "Role types" below.
  • "User Count": the number of active teammates who hold the role. A yellow "+N not active" badge next to it counts accounts that are assigned to the role but cannot use it: people who have not accepted their invitation, deactivated accounts, and accounts that were permanently deleted while they still held the role.
  • "Actions": the buttons for the role.

The action buttons:

  • "View" (eye) opens the role. Everyone who can see this page has it.
  • "Edit" (pencil) opens a custom role for editing.
  • "Duplicate as Custom Role" (copy) makes a custom copy of any role.
  • "Delete" (bin) deletes a custom role.

"Edit" and "Delete" are only on custom roles. "Edit", "Duplicate as Custom Role" and "Delete" are only shown to people with the 'Manage Roles' permission. With only 'View Team' you can read every role but change nothing.

If the roles cannot be loaded, the page shows "Couldn't load the roles." with a "Try again" button. "No roles found" is shown only when the organization has no roles at all.

Role types

"System" is the Owner role. It has full access to everything, including pages and actions that are added to Squid later. It cannot be edited or deleted. An Owner can copy it.

"Predefined" roles are the standard roles Squid ships with: "Admin", "Supervisor", "Senior Agent", "Agent" and "Viewer". You can change a predefined role's name and description, but not its permissions. Squid sets the permissions of predefined roles itself and brings them up to date with each release, so they can change when Squid adds a feature. A name you changed is kept. Your own description is kept unless it is empty or matches older built-in wording that Squid replaces during an update. A predefined role cannot be deleted. To get a variation of one, copy it and change the copy.

"Custom" roles are the ones your team made. Their name, description and permissions can all be changed, and they can be deleted when nobody is assigned to them. The release update that refreshes predefined roles leaves custom roles alone, so a custom role does not get a new permission automatically the way "Admin" does. There is one exception: when Squid starts asking for a new permission for something people could already do, a release can add that permission to the custom roles that hold the matching older permission, so they do not lose access. Check your custom roles after a new feature arrives if they should be able to use it.

Create Custom Role

Needs the 'Manage Roles' permission.

"Create Custom Role" at the top right opens an empty role, where you give it a name and tick its permissions. The button is only shown to people with the 'Manage Roles' permission.

If you want a role that is close to an existing one, "Duplicate as Custom Role" is quicker than starting empty.

Duplicate a role

Needs the 'Manage Roles' permission.

The copy button on a row opens the "Duplicate as custom role" dialog.

"Name for the copy" starts as the original's name followed by "(Copy)". Change it if you like; it cannot be empty, and two roles cannot have the same name. If the name is taken, the dialog says "A role with that name already exists. Pick another name."

"Create copy" creates a new custom role with the original's description and every permission the original has. The original stays as it is, and nobody is assigned to the copy yet. "Cancel" closes the dialog without copying.

You can only copy a role whose permissions you all hold yourself. Someone who is not an Owner cannot copy the Owner role, for example, because the copy would hand out permissions that person does not have. Owners can copy any role.

Delete a role

Needs the 'Manage Roles' permission.

The bin button deletes a custom role after you confirm in the "Delete Role" dialog. Deleting cannot be undone.

A role cannot be deleted while anyone is assigned to it. That includes accounts counted under "not active": invited people who have not accepted yet, deactivated accounts, and permanently deleted accounts. The button is greyed out and says "Cannot delete a role with assigned users". Give those people another role under Settings → Team first.

A permanently deleted account keeps its role and is no longer listed under Settings → Team, so its role cannot be changed there afterwards. If you plan to delete a custom role, move people to another role before you permanently delete their accounts.

System and predefined roles have no delete button.

Creating, copying and deleting a role are recorded in the audit log with the role's name and permissions. A change is recorded when the name or the permissions changed, with the old and the new value; changing only the description is not recorded.