Docs Home → View & Analyze Data → Atlas Charts
Embed Dashboards with an iframe
On this page
- Prerequisites
- Procedure
- Select a dashboard.
- Select Embed.
- Enable external sharing on the data source.
- Select the Unauthenticated tab in the dialog window.
- Toggle Enable unauthenticated access to On.
- (Optional) Specify filterable fields for your dashboard.
- Select the panel labeled Iframe.
- Set options.
- Copy the iframe embedding code.
- (Optional) Set additional options.
You can embed a dashboard into a web application with an iframe and specify settings such as height, width, refresh interval, and display theme.
You can embed only dashboards that don't require authentication (unauthenticated) within an iframe.
Prerequisites
You must be a dashboard Author to enable embedding for a dashboard.
Procedure
Select a dashboard.
From your dashboard page, select the dashboard to embed.
Select Embed.
From the dashboard, click at the top-right of the dashboard to access its embedding information. Select Embed from the dropdown menu.
Enable external sharing on the data source.
If you have already enabled external sharing on the data source that this dashboard uses, skip this step. If you haven't yet enabled embedding on the data source, you can do so now. Click the Configure link.
Select the Unauthenticated tab in the dialog window.
Toggle Enable unauthenticated access to On.
(Optional) Specify filterable fields for your dashboard.
Specify the fields on which dashboard viewers can filter data. By default, no fields are specified, meaning the dashboard cannot be filtered until you explicitly allow at least one field.
Alternatively, you can specify all the fields in your dashboard by selecting Allow all fields in the data source used in this dashboard.
To learn more about filterable fields, see Specify Filterable Fields.
Select the panel labeled Iframe.
Selecting the Iframe panel reveals the iframe embedding code and allows you to set refresh and display theme options.
Set options.
Specify the maximum age of data to load from the cache when loading or refreshing the embedded dashboard.
Specify whether the embedded dashboard automatically refreshes.
Select the Light or Dark display theme for your embedded dashboard.
Specify whether to fix the width of the charts within the dashboard or to scale the width of the charts to fit the embedded dashboard.
Specify whether to fix the height of the charts within the dashboard or to scale the height of the charts to fit the embedded dashboard.
Specify whether to display the title and description on the embedded dashboard.
Copy the iframe embedding code.
The iframe embedding code contains your dashboard's base URL and dasboard ID, as well as any options you have set.
(Optional) Set additional options.
You can edit the iframe code manually to set several other dashboard options, including height, width, and border radius. To learn more, see Embedded Dashboard Options.
After your iframe code is ready with any options you've set, you can place it in a web page to display your dashboard.