SquidSupport
Product reference / Settings

Create a custom role

In the app: Settings → Roles → Create Custom Role

Needs the 'Manage Roles' permission.

The form for a new custom role: a name, an optional description and the permissions the role gives. Use it when none of the standard roles fits, for example a role that may answer tickets but may not refund. The role is created for the whole organization. You reach the form from Settings → Roles, which also needs the 'View Team' permission.

Name and description

"Name" is required and can be up to 100 characters. It must be different from every other role in the organization. It is the name people see on Settings → Team and when someone is invited.

"Description" is optional. It is shown under the name in the role list. Use it to say what the role is for.

Permissions

The permissions are grouped in categories. Each category shows how many of its permissions are ticked, and the line above the list shows the total, for example "0 of 122 permissions selected". Nothing is ticked when you start.

Click a category to open it. Each permission has a short explanation. Tick single permissions, or use "Select All" or "Deselect All" on a category.

Rules:

  • At least one permission. A role with nothing ticked gives no access at all, so it cannot be created: "Choose at least one permission. A role with none grants no access at all."
  • Only permissions you hold yourself. If you tick a permission you do not have, creating the role is refused with "You cannot put permissions into a role that you do not have yourself." and the permission's internal key. Owners can tick any permission.
  • Permissions that need another one. A permission to change something needs the matching permission to view it, where Squid has one. When you tick one without the other, a yellow warning lists what is missing, and "Add the missing permission" (or "Add the missing permissions") ticks it for you. The warning does not block creating the role.

If the new role should be close to an existing one, go back to Settings → Roles and use "Duplicate as Custom Role" there instead: the copy starts with the original's description and all its permissions.

Creating the role

"Create Role" creates the role and opens it. A missing name is refused with "Give this role a name." "Cancel" goes back to the role list without creating anything. Leaving the page after you have filled something in asks you to confirm first.

A name that another role already uses is refused with "A role named '…' already exists".

Creating a role does not give it to anyone. Assign it to people under Settings → Team, or pick it when you invite someone. The new role is recorded in the audit log.