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

CapabilityCustom roleViewerUserWorkspace Administrator
Access to existing viewsAll views in the workspace based on the selected permissionsOnly views explicitly shared with themOnly views explicitly shared with themAll views in the workspace
Access to new viewsAutomatic for the selected entityNo, until sharedNo, until sharedAutomatic
Create or modify reportsYes, if grantedNoNoYes
Add or modify dataYes, if grantedNoYes, in shared tablesYes
Administrative privilegesNoneNoneNoneAll, except renaming, deleting, or backing up the workspace

Create a custom role

  1. Click the Organization Settings icon at the top right of your account.
  2. In the left panel, click Manage Roles under General.
  3. Click Add New Role. The Create Role dialog opens.

    Manage Roles page with the Add New Role button

  4. In the Role Name field, enter a name for the role.
  5. 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.
  6. Select the other permissions the role requires.

    Create Role dialog showing access, creation, data, design, interaction, and collaboration permissions

  7. 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

PermissionDescriptionAll DashboardsAll Reports And DashboardsAll Data, Reports And Dashboards
Create DashboardsAllows users to create dashboards.—YesYes
Create ReportsAllows users to create and edit reports.——Yes
Create Table / Import DataAllows users to create tables and import data.——Yes
Create Query TableAllows users to create query tables.——Yes
Formula Column / Aggregate Formula / Bucket ColumnAllows users to add formulas and bucket columns.——Yes
Create FolderAllows users to create folders.YesYesYes

Data permissions

Available only with the All Data, Reports And Dashboards access permission.

PermissionDescription
Add RowUsers can add rows to the table.
Delete RowUsers can delete rows in the table.
Modify RowUsers can modify rows in the table.
Only Append RowsUsers can only append rows in the table while importing.
Delete All Rows And Add New RowsUsers can delete all rows and append rows in the table while importing.
Add Or Update RowsUsers can append and modify rows in the table while importing.
Add New, Replace Existing, And Delete Missing RowsUsers can add, update, and delete rows in the table while importing.
Create, Modify, And Delete Data ArchivesUsers 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.

PermissionDescription
Read AccessGrants read access. Selected by default and cannot be cleared.
View Underlying DataUsers can view the underlying data of reports.
Drill DownUsers can drill down reports.
Drill ThroughUsers can drill through reports.
Drill ActionsUsers can use drill actions in reports.
Zia InsightsUsers can use Zia Insights to get narrative analysis.
GenAI SkillsUsers can use GenAI skills.

Sharing and collaboration permissions

These permissions are available for every access permission type.

PermissionDescription
Share Views / Child ReportsUsers can reshare views and child views.
Commenting ActionsUsers can comment on shared views.
Private LinksUsers can generate private links for tables, reports, and dashboards for easy collaboration.
Access Admin/Owner PresetsUsers can access presets (saved combinations of dashboard user filters) created by administrators and owners.
Allow Preset CreationUsers 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.

PermissionDescriptionAll DashboardsAll Reports And DashboardsAll Data, Reports And Dashboards
ExportUsers can export data.YesYesYes
Manage Email SchedulesUsers can create and manage email schedules. The Manage Email Schedule created by them link allows you to restrict which schedules can be managed.YesYesYes
Manage Data AlertsUsers can create and manage data alerts. The Manage Alerts created by them link allows you to restrict which alerts can be managed.—YesYes
Create SlideshowUsers can create slideshow links for views.YesYesYes
Public ViewsUsers can generate public links for views.YesYesYes

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.

PermissionDescription
View Data SourceUsers 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 SourceUsers 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 DataUsers can use the Sync Now option and the Retry Sync option when an import fails.
Edit Data SourceUsers 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 SourceUsers 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

  1. Open Organization Settings > General > Manage Users.
  2. Click Add Users. The Add Users dialog opens.
  3. In the Role field, select the custom role you want to assign.
  4. In the Select Workspace field, select the required workspaces.
  5. Enter the users' email addresses in the Enter Email Addresses field, or click Pick Users to select users from your contacts.
  6. Click Add to add the users with the assigned permissions.

    Add Users dialog for assigning a custom role from Organization Settings

From a workspace

  1. Open the required workspace.
  2. Go to Settings > Manage Users.
  3. Click Add Users or select an existing user.
  4. Assign the required custom role.
  5. Save the changes and click Apply.

    Workspace Manage Users page for assigning a custom role

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.

  1. Go to Organization Settings > Manage Users.
  2. Hover over the Organization Administrator's role and click Change role.
  3. Select User from the Role drop-down and click Apply.

    Change Role dialog for changing an Organization Administrator to a User

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

Change a Workspace Administrator to a custom role

  1. Open Workspace Settings > Manage Users.
  2. Select the required user.
  3. Change the user from Workspace Administrator to the required custom role.
  4. Click Apply.

    Change Role dialog for assigning a custom role to a Workspace Administrator

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.

  1. Go to Organization Settings > Manage Users.
  2. Hover over the Viewer's role and click Change role.
  3. Select User from the Role drop-down and click Apply.
  4. Open the required workspace and navigate to Workspace Settings > Manage Users.
  5. Hover over the user's role and click Change role.
  6. Select the required custom role from the Role drop-down.
  7. Select or clear Notify users through email, and click Apply.

    Change Role dialog for changing a Viewer before assigning a custom role

  • 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

  1. Hover over the role and click Edit.
  2. Update the required permissions.
  3. Click OK.

Duplicate a custom role

  1. Hover over the role and click Duplicate.
  2. Update the role name, if needed.
  3. Click OK.

Delete a custom role

  1. Select one or more custom roles.
  2. Click Delete Roles.
  3. 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.