Manage Custom Roles
Overview
Analytics Plus allows you to create custom user roles, beyond the predefined ones, to control what users can access and do within a workspace. Custom roles let you create permission sets that match the responsibilities of specific users or teams.
The following are some examples of what you can configure with custom roles:
- Grant fine-grained permissions instead of the broader permission set bundled in a predefined role.
- Give users access to all views of a selected entity in a shared workspace, without sharing each view individually.
- Allow users to create reports and dashboards without granting administrator privileges.
The Account Administrator and Organization Administrators can create and manage custom roles.
What is in this page
- How custom roles differ from predefined roles
- Create a custom role
- Manage custom roles
- Frequently asked questions
How custom roles differ from predefined roles
| Capability | Custom role | Viewer | User | Workspace Administrator |
|---|---|---|---|---|
| Access to existing views | All views in the workspace based on the selected permissions | Only views explicitly shared with them | Only views explicitly shared with them | All views in the workspace |
| Access to new views | Automatic for the selected entity | No, until shared | No, until shared | Automatic |
| Create or modify reports | Yes, if granted | No | No | Yes |
| Add or modify data | Yes, if granted | No | Yes, in shared tables | Yes |
| Administrative privileges | None | None | None | All, except renaming, deleting, or backing up the workspace |
Create a custom role
- Click the Organization Settings icon at the top right of your account.
- In the left panel, click Manage Roles under General.
Click Add New Role. The Create Role dialog opens.

- In the Role Name field, enter a name for the role.
- In the Access Permissions section, select the entities the role can access: All Dashboards, All Reports And Dashboards, or All Data, Reports And Dashboards. The remaining options vary based on this selection.
Select the other permissions the role requires.

- Click Add. The role is created and listed on the Manage Roles page. You can now assign it to users.
Custom role permissions
A custom role's permissions are broadly categorized into access, creation, data, design, interaction, sharing and collaboration, data source, and publishing permissions.
Access permissions
- All Dashboards: Gives access to all dashboards in the shared workspace. This suits users such as a CIO who views dashboards for analysis but does not work with reports or data.
- All Reports And Dashboards: Gives access to all reports and dashboards in the shared workspace. Users with this permission can also create dashboards and folders. Creating reports requires access to data, so it is available only with the All Data, Reports And Dashboards permission.
- All Data, Reports And Dashboards: Gives access to the data, reports, and dashboards in the shared workspace. Users with this permission can create tables and import data, create query tables, use formula columns and aggregate formulas, and create reports and dashboards.
The remaining permissions depend on the access permission selected for the custom role.
Create permissions
| Permission | Description | All Dashboards | All Reports And Dashboards | All Data, Reports And Dashboards |
|---|---|---|---|---|
| Create Dashboards | Allows users to create dashboards. | — | Yes | Yes |
| Create Reports | Allows users to create and edit reports. | — | — | Yes |
| Create Table / Import Data | Allows users to create tables and import data. | — | — | Yes |
| Create Query Table | Allows users to create query tables. | — | — | Yes |
| Formula Column / Aggregate Formula / Bucket Column | Allows users to add formulas and bucket columns. | — | — | Yes |
| Create Folder | Allows users to create folders. | Yes | Yes | Yes |
Data permissions
Available only with the All Data, Reports And Dashboards access permission.
| Permission | Description |
|---|---|
| Add Row | Users can add rows to the table. |
| Delete Row | Users can delete rows in the table. |
| Modify Row | Users can modify rows in the table. |
| Only Append Rows | Users can only append rows in the table while importing. |
| Delete All Rows And Add New Rows | Users can delete all rows and append rows in the table while importing. |
| Add Or Update Rows | Users can append and modify rows in the table while importing. |
| Add New, Replace Existing, And Delete Missing Rows | Users can add, update, and delete rows in the table while importing. |
| Create, Modify, And Delete Data Archives | Users can create, modify, and delete data archives. |
Note: Archive permissions can be enabled only when all other data permissions are enabled.
Design permission
Users can edit the structure of tables, reports, and dashboards, including adding and deleting columns, adding lookup columns, and accessing report settings.
Interaction permissions
These permissions are available for every access permission type.
| Permission | Description |
|---|---|
| Read Access | Grants read access. Selected by default and cannot be cleared. |
| View Underlying Data | Users can view the underlying data of reports. |
| Drill Down | Users can drill down reports. |
| Drill Through | Users can drill through reports. |
| Drill Actions | Users can use drill actions in reports. |
| Zia Insights | Users can use Zia Insights to get narrative analysis. |
| GenAI Skills | Users can use GenAI skills. |
Sharing and collaboration permissions
These permissions are available for every access permission type.
| Permission | Description |
|---|---|
| Share Views / Child Reports | Users can reshare views and child views. |
| Commenting Actions | Users can comment on shared views. |
| Private Links | Users can generate private links for tables, reports, and dashboards for easy collaboration. |
| Access Admin/Owner Presets | Users can access presets (saved combinations of dashboard user filters) created by administrators and owners. |
| Allow Preset Creation | Users can create presets (saved combinations of dashboard user filters). |
Publishing permissions
Publishing permissions are available based on the access permission selected for the custom role.
| Permission | Description | All Dashboards | All Reports And Dashboards | All Data, Reports And Dashboards |
|---|---|---|---|---|
| Export | Users can export data. | Yes | Yes | Yes |
| Manage Email Schedules | Users can create and manage email schedules. The Manage Email Schedule created by them link allows you to restrict which schedules can be managed. | Yes | Yes | Yes |
| Manage Data Alerts | Users can create and manage data alerts. The Manage Alerts created by them link allows you to restrict which alerts can be managed. | — | Yes | Yes |
| Create Slideshow | Users can create slideshow links for views. | Yes | Yes | Yes |
| Public Views | Users can generate public links for views. | Yes | Yes | Yes |
Data source permissions
These permissions are available only with the All Data, Reports And Dashboards access permission. They determine whether users with the role can access data sources created by other users and what they can do with those sources.
| Permission | Description |
|---|---|
| View Data Source | Users can access the Data Sources page and view the data source connections in a workspace, including the sync history, audit history, and last import details of each table. |
| Use Data Source | Users can import new tables using an existing data source connection. This permission is available only when the Create Table / Import Data permission is enabled. |
| Sync Data | Users can use the Sync Now option and the Retry Sync option when an import fails. |
| Edit Data Source | Users can reauthenticate or edit the connection details, manage the sync interval and import settings, move tables to a different schedule, and remove tables from the connection. |
| Remove Data Source | Users can remove the data source. |
Note:
- Data source permissions apply to essential connectors and sources only, and only to sources or connections created by other users in a workspace. Users with custom roles are automatically granted full access to the sources they own.
- For business connectors, only Organization Administrators can set up a connection, manage modules and fields, and manage sync settings. Workspace Administrators and users with custom roles cannot manage business connectors.
Manage custom roles
The Account Administrator and Organization Administrators can manage custom roles from Organization Settings > General > Manage Roles.
Assign users to a custom role
Users can be assigned a custom role either from Organization Settings or from the Manage Users section of a workspace's settings.
From Organization Settings
- Open Organization Settings > General > Manage Users.
- Click Add Users. The Add Users dialog opens.
- In the Role field, select the custom role you want to assign.
- In the Select Workspace field, select the required workspaces.
- Enter the users' email addresses in the Enter Email Addresses field, or click Pick Users to select users from your contacts.
Click Add to add the users with the assigned permissions.

From a workspace
- Open the required workspace.
- Go to Settings > Manage Users.
- Click Add Users or select an existing user.
- Assign the required custom role.
Save the changes and click Apply.

Change an Organization Administrator to a custom role
Custom roles cannot be assigned to Organization Administrators directly. Change the administrator to a User first, and then assign the custom role from the workspace.
Note: Only the Account Administrator can assign or change the Organization Administrator role. Organization Administrators cannot change the roles of other Organization Administrators.
- Go to Organization Settings > Manage Users.
- Hover over the Organization Administrator's role and click Change role.
Select User from the Role drop-down and click Apply.

- Open the required workspace and navigate to Workspace Settings > Manage Users.
- Hover over the user's role and click Change role.
- Select the required custom role from the Role drop-down.
- Select or clear Notify users through email, and click Apply.
Change a Workspace Administrator to a custom role
- Open Workspace Settings > Manage Users.
- Select the required user.
- Change the user from Workspace Administrator to the required custom role.
Click Apply.

Change a Viewer to a custom role
Custom roles cannot be assigned to Viewers directly. Change the Viewer to a User first, and then assign the custom role from the workspace.
- Go to Organization Settings > Manage Users.
- Hover over the Viewer's role and click Change role.
- Select User from the Role drop-down and click Apply.
- Open the required workspace and navigate to Workspace Settings > Manage Users.
- Hover over the user's role and click Change role.
- Select the required custom role from the Role drop-down.
Select or clear Notify users through email, and click Apply.

- Note: If a user assigned to a custom role is removed from a workspace, the role assignment for that workspace is also removed.
- A user can be assigned different custom roles across workspaces, but only one role can be assigned per workspace.
Edit a custom role
- Hover over the role and click Edit.
- Update the required permissions.
- Click OK.
Duplicate a custom role
- Hover over the role and click Duplicate.
- Update the role name, if needed.
- Click OK.
Delete a custom role
- Select one or more custom roles.
- Click Delete Roles.
- Confirm the deletion.
Before deleting a role, reassign its users to another appropriate role so they retain the access they need.
Frequently asked questions
1. Who can create custom roles?
The Account Administrator and Organization Administrator roles can create, edit, duplicate, and delete custom roles.
2. How many custom roles can I create?
You can create any number of custom roles in your organization. A user can be assigned different custom roles across multiple workspaces, with a maximum of one role per workspace. Licensing is calculated based on the number of users, not the number of roles assigned to them.
3. How many users can I assign to a custom role?
You can assign a custom role to any number of users. Each user can have different custom roles across different workspaces, but only one role can be assigned per workspace. Licensing is calculated based on the number of users in your organization, not the roles assigned to them.
4. Can users with a custom role share views?
Yes. Users with a custom role can share the views they have access to if the role includes the Share Views / Child Reports permission under Sharing and collaboration permissions.
5. What happens to custom roles if I downgrade my plan?
All users who were assigned a custom role are changed to the predefined User role. Their custom roles are restored when you upgrade again.

