Share a dashboard

This article provides recommendations for publishing and sharing dashboards and outlines the steps to share a published dashboard.

Who can access your dashboard?

You can share dashboards with users and groups in your Azure Databricks account or workspace. Users registered to your workspace can be assigned varying levels of permissions that define their interaction capabilities with your dashboards.

Users who are not members of the workspace are limited to view-only access to your dashboard. They can view and run the dashboard but cannot edit or manage it. This access level aligns with view-only roles in other data visualization systems, with the added benefit of not requiring a special license.

Workspace member access

You can grant workspace users permission to view, edit, or manage your dashboard. See AI/BI dashboard ACLs. Workspace users with access to your dashboard can access both the draft or published versions. Workspace users must have at least CAN EDIT permission in order to modify and republish a draft.

Dashboards inherit the permissions set on the enclosing folder. By default, dashboards are stored in the /Workspace/Users/<username> directory. Anyone who has access to the enclosing folder can also access your dashboard. Only workspace admins can change ownership of a dashboard. See Dashboard administration guide.

Account member access

Members of your Databricks account who do not have access to the workspace can be granted access to a view-only copy of a dashboard published with embedded credentials. They use the publisher’s embedded credential to access the data displayed in the dashboard and the compute resources that run the underlying queries. That means account-level viewers do not require compute or data permissions. Members who do not have access to the workspace cannot access the draft version of the dashboard and will not see the Databricks workspace navigational elements at left or top.

For members of your account to access shared dashboards, an administrator must first register them with your Azure Databricks account. See Dashboard administration guide. This step restricts access to the shared dashboard to only designated members of the account, rather than allowing anyone with the link to view it.

Data and compute for shared dashboards

To effectively share insights on a dashboard, viewers must be able to access the underlying data and the compute resources necessary to run the supporting queries that keep the dashboard updated. They can be provided access to those resources in one of the following ways:

Embed credentials (default): When you publish a dashboard, you can optionally embed your credentials. Embedding your credentials allows viewers to leverage your data and compute access so that they have the same view of the dashboard as you. It also allows all viewers to use the same shared cache for maximum efficiency.

Don’t embed credentials: When credentials are not embedded, each dashboard viewer’s own data and compute credentials are applied. A workspace admin can manage access to data and compute resources. Users who do not have access to the dashboard’s originating workspace can’t be granted access to compute resources. Effectively, this limits dashboard access to only those users with workspace access.

If you opt not to embed your credentials, you must verify that viewers have the necessary data and compute access to view the data displayed on the dashboard. Choose Embed credentials if you want to share with users who don’t have access to the workspace.

For draft dashboards, the viewer’s data permissions are always applied, even if the dashboard is published with embedded credentials.

Share a published dashboard

Published dashboards can be shared with the following:

• Specific users and groups in your workspace
• Specific users and groups in your Azure Databricks account
• All users in your Azure Databricks account

If you want to share with everyone in your Azure Databricks account, use the sharing setting: Anyone in my account can view. If you want to share with everyone in your workspace, use the system group: All workspace users.

Use the following steps to share your dashboard:

1. Open a draft or published dashboard.

2. Click the Share button, and use the Sharing dialog to set permissions for users and groups in your account.

   • At the top of the dialog, enter users and groups that you want to share with. You can assign specific permission levels, such as CAN EDIT and CAN MANAGE. Then, click Add.
   • To quickly assign view access for anyone in your Azure Databricks account, use the Sharing settings option at the bottom of the Sharing dialog.

   

   Users need access to the workspace to manage or edit a dashboard. Workspace admins can add users to the workspace. See Assign a user to a workspace using the account console.

   Note

   Users who do not have access to the workspace are limited to CAN RUN permissions. If you grant elevated permissions, such as CAN EDIT, to a user who does not have workspace access, those permissions appear in the Sharing dialog but their actual permissions are limited to CAN RUN. Elevated permissions cannot be applied unless the user is added to the workspace. If the user is assigned a higher permission level and is later added to the workspace, they can interact with dashboards according to the assigned permission. See AI/BI dashboard ACLs for more information on dashboard permission levels.

3. Share the link with users.

   • Click Copy link near the bottom of the Sharing dialog to copy a shareable URL for the published dashboard.
   • Optionally, you can embed your dashboard in a different website or application.

Embed a dashboard

Using an iframe, you can embed a published dashboard into external websites and applications. Users with at least CAN EDIT permission can generate the iframe code from the Share dialog.

To embed a dashboard:

1. Click Embed dashboard in the Sharing dialog.

2. A Copy embed code dialog opens. If a list of allowed embedding domains exists, the domains are listed. Copy the code snippet.

   

3. Insert the embed code into any platform or application that supports HTML embedding and can render iframe content.

Note

If your Copy embed code dialog includes a list of allowed domains that does not include your target domain, you can ask your workspace admin to add it. See Manage dashboard embedding.

View an embedded dashboard

Embedded dashboards offer a secure way for viewers to access dashboard data outside of Azure Databricks. All existing sharing settings apply. Intended viewers must be granted access to the dashboard. See Who can access your dashboard?.

To view an embedded dashboard:

• Navigate to the page where the dashboard has been embedded.
• If necessary, log in with Azure Databricks credentials.

Note

If a registered user who has not been granted access to the dashboard tries to view it, they receive an error that says the dashboard is unavailable. See Share a published dashboard to learn how to adjust sharing settings.

Refresh an embedded dashboard

All viewers of an embedded dashboard can manually refresh dashboards on demand. You can also set up a schedule to refresh dashboards periodically.

See Manage scheduled dashboard updates and subscriptions.

Troubleshooting embedded dashboards

This section lists common problems that you might encounter and offers a suggested resolution:

The embedded iframe is blank

If the embedded iframe is not displaying data, it might be because you have disabled third-party cookies. Enabling third-party cookies is often necessary to allow external content, such as embedded dashboards, to function correctly within another web page.

You can adjust your browser settings to allow or unblock third-party cookies to resolve this issue. If you don’t want to allow all third party cookies, many browsers allow you to add exceptions for specific sites on which third-party cookies should be allowed. Refer to your browser’s help documentation for detailed instructions on managing cookies.