Share Dashboards

By default, a newly created dashboard is accessible only to the user who created it, and to users with at least a Workspace.MANAGE level permission to the workspace the dashboard is in. Use the share dashboard functionality described in this article to let other users and user groups access the dashboard.

Dashboards that you have created and that you have not shared with anyone else are listed in your PRIVATE dashboards tab:

Dashboard Share Button

For a more detailed explanation on how dashboard sharing works on the backend, and how to manage this functionality using the API, see Manage Dashboard Permissions.

Permission Levels

When you share a dashboard with another user or user group, you assign them a certain permission level. The permission levels work hierarchically - each subsequent permission level includes all the rights of the previous level:

  • View

    Users can view and interact with the dashboard.

  • View & Share

    Users can share the dashboard with other users, up to the View & Share permission level.

  • Edit & Share

    Users can edit or delete the dashboard. Users can share the dashboard with other users, up to the Edit & Share permission level.

Eligible Users

By default, you can only share a dashboard with users and user groups that have access to the workspace where the dashboard is located. The user or user groups requires at least a Workspace.VIEW level permission to the workspace.

The Edit & Share can only be given to users and user groups in the native workspace of the dashboard. The dashboard cannot be edited from a child workspace.

Share a Dashboard

UI
API
  1. Open your dashboard and click on the Share button in the top right corner.

    Dashboard Share Button

The share dialog opens, listing all users and user groups the dashboard is being currently shared with.

  1. Click the + Add button to share the dashboard with additional users and user groups.

    Dashboard Share Dialog
  2. Add a user or user group.

    Dashboard Share Dialog Select User
  3. Select the level of access you want to assign to the given user or user group.

    Dashboard Share Dialog Select Permission
  4. Click Share to confirm the changes.

    Dashboard Share Dialog Select Permission

The user or user group you shared the dashboard with should now have access to the dashboard.

To share dashboards using the API you need to understand and manage dashboard permissions directly, see Manage Dashboard Permissions.

Troubleshooting

The web UI shows user or user group as having permission to a dashboard, but the users cannot access it.

This situation can occur if the user or user group:

  • lost permission to access the workspace the dashboard is in, or
  • lost hierarchyPermission to access a parent workspace of the child workspace the dashboard is in, or
  • was never given the necessary permission to the workspace in the first place, and was added using the API or because they were added using the SEE permission

To enable access to the dashboard, a user with Workspace.ANALYZE permission to the workspace the dashboard is in can assign the required workspace permission to the affected user or user group.

A dashboard is in my PRIVATE dashboards tab even though I did not create it.

The condition a dashboard has to fulfill to be private is: Only a single user has permission to access the dashboard, and that user is the currently logged-in user.

It is possible that this situation occured as a result of someone removing dashboard permissions from its original creator, and assigning them to you.