Skip to main content

Roles

Control what internal users can access and edit

Written by Support
Updated yesterday

Roles are a key part of managing security and structure across the platform. They define what internal users can see and do across both the CMS and the front-end website or app.

By using roles, you can ensure users only have access to the features they need.

What are roles used for?

Roles are used to control access to features across the platform, including:

  • CMS functionality (e.g. managing content, users, and assets)

  • Front-end access (what users can view or interact with on the website or app)

They help you:

  • Maintain security and control

  • Reduce user error by limiting access

  • Standardise permissions across teams

Where to manage roles

To access roles, navigate to:
​ONE Admin > Users > Roles

Creating and managing roles

Roles are fully customisable - you can create as many (or as few) as you need by combining different permissions.

Add a New Role

To create a new role:

  1. Click '+ Add Role' (top right of the screen)

  2. A form will open where you can name the role

  3. Select the relevant permissions for that role

  4. Save your changes

Edit an Existing Role

To update a role:

  1. Find the role in the list

  2. Click the Actions menu on the right-hand side

  3. Select 'Edit'

  4. Make your changes and save

Delete an Existing Role

To remove a role:

  1. Find the role in the list

  2. Click the Actions menu on the right-hand side

  3. Select 'Delete'

  4. Confirm deletion

What do role permissions allow?

Each role is made up of permissions that define what a user can do. You can view a description of each permission in two ways:

  • Hover over the '?' icon in the CMS for a quick explanation

  • Review the full permission list here for detailed descriptions

Applying a role to a user

Once a role has been created, you can assign it to a user:

  1. Go to ONE Admin > Users

  2. Find the user you want to update

  3. Click the Actions menu for that user

  4. Select 'Edit'

  5. Scroll to the 'Roles' option and assign the relevant role and save

Why roles matter

  • Keep access secure and controlled

  • Ensure users only see what they need

  • Make permission management scalable

  • Reduce manual configuration errors

Tips

  • Build roles based on job function

  • Use a small number of well-structured roles instead of many overlapping ones

  • Test roles with a sample user before rolling out widely

Roles give you powerful control over your platform - helping you manage access clearly, consistently, and at scale.

Did this answer your question?