---
title: "Add a role"
slug: "add-a-role"
updated: 2026-06-01T08:23:19Z
published: 2026-06-01T08:23:19Z
canonical: "docs.grassfish.com/add-a-role"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.grassfish.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Add a role

Use roles to specify which permissions a user has.

## Prerequisites

Before you create a new role, read the following information to better understand roles and access levels:

- **Administrator**: Administrators can access all locations by default.
- **View**: The role has read-only access to a feature. Users can see the information, but they can't make any changes.
- **Edit**: The role can view and edit the feature. This includes adding, deleting, or updating any items or settings.
- **Hide**: The role has no access and can't see the feature.

## Add a new role

To add a new role, perform the following steps:

1. In the sidebar, click **Users & Roles**.
2. Click **Add new** in the header.
3. Select **Add role**.

![Add a new user role](https://cdn.document360.io/e2b87f73-d9f5-43cb-8182-2641762664fd/Images/Documentation/user_roles_add(1).png?sv=2026-02-06&spr=https&st=2026-10-26T13%3A13%3A28Z&se=2026-10-26T14%3A13%3A28Z&sr=c&sp=r&sig=qR3AqzIxSpsQ3ZbOODkirZzcG5kIdPH5Y%2F0%2F5P9XBfk%3D)
4. Under **General role settings**, specify the following details:
  - **Role name**: Enter a name for the role.
  - **Role description**: Enter a description of the role.
5. Set the role functions in the following way:
  - **View**: Users with this role can only view.
  - **Edit**: Users with this role can edit.
  - **Hide**: Users with this role can't view.
6. Click on each feature on the left side and select the access level you want to assign to the role.
7. When you’re done, click **Save** to save the new role.

![Image of configuring role settings.](https://cdn.document360.io/e2b87f73-d9f5-43cb-8182-2641762664fd/Images/Documentation/user_roles_add.png?sv=2026-02-06&spr=https&st=2026-10-26T13%3A13%3A28Z&se=2026-10-26T14%3A13%3A28Z&sr=c&sp=r&sig=qR3AqzIxSpsQ3ZbOODkirZzcG5kIdPH5Y%2F0%2F5P9XBfk%3D)

> [!NOTE]
> Note
> 
> The new role is added as a new tab.

---

#### Example: Permissions for a marketing role

When creating a role for a Marketing Coordinator, you can tailor their access to match their responsibilities. Here's how you might configure their permissions:

- **Media Library: Edit** – They can add, update, and delete media files.
- **Broadcasts: View** – They can see scheduled broadcasts but cannot make changes.
- **Settings: Hide** – They don’t need access to system settings; that’s for administrators.

This setup ensures the marketing coordinator has the tools they need without access to areas outside their role.

The application's main menu on the left side.

The top section of the interface.