# 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](https://www.manageengine.com/analytics-plus/cloud-help/custom-role.html#role-comparison) - [Create a custom role](https://www.manageengine.com/analytics-plus/cloud-help/custom-role.html#create-custom-role) - [Custom role permissions](https://www.manageengine.com/analytics-plus/cloud-help/custom-role.html#custom-role-permissions) - [Manage custom roles](https://www.manageengine.com/analytics-plus/cloud-help/custom-role.html#manage-custom-roles) - [Assign users to a custom role](https://www.manageengine.com/analytics-plus/cloud-help/custom-role.html#assign-users) - [Change an Organization Administrator to a custom role](https://www.manageengine.com/analytics-plus/cloud-help/custom-role.html#change-organization-admin) - [Change a Workspace Administrator to a custom role](https://www.manageengine.com/analytics-plus/cloud-help/custom-role.html#change-workspace-admin) - [Change a Viewer to a custom role](https://www.manageengine.com/analytics-plus/cloud-help/custom-role.html#change-viewer) - [Edit a custom role](https://www.manageengine.com/analytics-plus/cloud-help/custom-role.html#edit-custom-role) - [Duplicate a custom role](https://www.manageengine.com/analytics-plus/cloud-help/custom-role.html#duplicate-custom-role) - [Delete a custom role](https://www.manageengine.com/analytics-plus/cloud-help/custom-role.html#delete-custom-role) - [Frequently asked questions](https://www.manageengine.com/analytics-plus/cloud-help/custom-role.html#faq) ## 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 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](https://cdn.manageengine.com/sites/meweb/images/analytics-plus/cloud-help/create-role-list.png) 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](https://cdn.manageengine.com/sites/meweb/images/analytics-plus/cloud-help/create-role-permissions.png) 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 | 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](https://www.manageengine.com/analytics-plus/cloud-help/dashboard/create-dashboard.html#preset-user-filter) (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 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](https://cdn.manageengine.com/sites/meweb/images/analytics-plus/cloud-help/assign-role-organization-settings.png) #### 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](https://cdn.manageengine.com/sites/meweb/images/analytics-plus/cloud-help/assign-role-workspace-settings.png) ### 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](https://cdn.manageengine.com/sites/meweb/images/analytics-plus/cloud-help/change-organization-admin-role.png) 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](https://cdn.manageengine.com/sites/meweb/images/analytics-plus/cloud-help/change-workspace-admin-role.png) ### 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](https://cdn.manageengine.com/sites/meweb/images/analytics-plus/cloud-help/change-viewer-role.png) - **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.