All Secretary guides

Custom Roles

Building a custom role

Define exactly what a role allows, for people who need more or less than a default role.

Step 1

When you need one

The default roles cover most people. A custom role fits in between: a contractor who may only read and chat, or a team lead who manages groups without being an Admin. Only Owners and Admins can build them.

1When you need one

Custom Roles

Give specific people exactly the permissions they need, in place of their default role

No custom roles yet

Create a role to give specific people the permissions they need, like managing groups or personas, without making them an admin.

Step 2

Start from the defaults

In Organization, press Role Access. Default Roles lists the five built-in roles with their permission counts and persona limits. Press one to see exactly what it allows, a good starting point for a custom role.

2Start from the defaults

Default Roles

Everyone holds exactly one role: one of these, or a custom role below in its place

Moderator

Can act on documents and folders beyond their own

Personas: up to 10
24 permissions

Contributor

Can create and edit content across the organization

Personas: up to 5
16 permissions
documents:editdocuments:deletefolders:createfolders:editfolders:deletepersonas:viewpersonas:createactions:viewactions:executehubs:viewhubs:createhubs:edithubs:deletehubs:manage-membersmodels:basicmodels:standard

Step 3

Name it

Press New Role, or Create First Role. Give it a name that says what the person does, an optional description, and a colour that marks it in lists.

3Name it

Create Role

Step 4

Tick the permissions

Permissions are grouped by area. The box next to an area's name ticks or clears all of it; grey means some are ticked. Then tick single permissions underneath.

4Tick the permissions

Create Role

documents
chat
models

Step 5

Include the basics

A custom role replaces the default role entirely, so it grants only what you tick. Whatever their role, everyone can always chat, upload, open the files and folders they have access to, see groups and see their own usage, so none of that has a box. Include at least one Models tier, or they will not be able to use any AI model.

5Include the basics

Create Role

models

Step 6

A read-only role

To let someone open, read, download and chat about files without changing anything, leave out Edit documents, Delete documents, Edit folders and Delete folders. They will not see Rename, Move, Delete, Restore or Replace anywhere, not even on files they uploaded themselves.

6A read-only role

Create Role

documents
folders

Step 7

Persona limit

Tick Personas Create and a Max personas per person box appears. Leave it blank for unlimited. It replaces the limit their default role would have had.

7Persona limit

Create Role

personas
Max personas per person3blank = unlimited

Step 8

Create Role

Create Role saves it under Custom Roles with its permission count. Assigning it to people is covered in Assigning and removing custom roles.

8Create Role

Create Role