Embed a report

Bring the power of Data Studio to your site, article, or message board.

Distributing a Data Studio report by sharing with email addresses, Google Groups, or public links requires the viewer to visit the Data Studio site to view the full report. Embedding, on the other hand, lets you include your report in your own page, making it easier for you to tell your data story as broadly as possible.

In this article:

Embedding example

Here's an example of an embedded report that illustrates how Data Studio colors your data:

Try it out!

The embedded report above is fully functional. You can:  

  • Interact with the charts
  • Use the navigation controls on the bottom to go to the second page
  • Open this report in Data Studio by clicking the Google Data Studio logo

(The full-screen option is disabled in the Help Center.)

How embedding works

  • You can embed a report in any site or app that supports the HTML iframe tag.
    • The iframe code includes a link to your report, and is automatically generated by Data Studio. No knowledge of HTML is required.
  • You can also embed in the new Google sites, and in any site that uses the oEmbed format.
  • You can embed public and private reports:
    • If the report is shared publicly, then anyone viewing your page can see the embedded report.
    • If the report is shared with specific users, groups, or domains, then only those folks can see the embedded report. These viewers must be logged into a Google account.
  • Embedded reports appear in view mode.
  • Embedded reports are functional and interactive: filters and date range controls work as normal. However, users can't edit, copy, or share the report, as there is no menu bar.
  • Viewers can't refresh the data in an embedded report. (The data will refresh as usual when the cache expires.)
  • Page navigation for multi-page reports appears in the bottom of the report.
  • Viewers can click a link in the bottom of the report to see it in Data Studio.
  • Embedded reports always contain the Google Data Studio watermark and full-screen option. You can't remove these.

Embed via HTML iframe

  1. Sign in to Data Studio.
  2. Edit the report you want to embed.
  3. Share the report:
    • For a public report, use the link sharing options "Public on the web" or "Anyone with the link can view"
    • For a private report, enter one or more users or Google Groups
    • G Suite users: To limit the report to users in your domain, turn link sharing on and select the "Anyone at [domain] with the link can view"
  4. Select File > Embed report, or in the upper right, click Embed.
  5. Click Enable embedding. A dialog box appears:Enable embedding dialog
    To embed a specific page of your report, navigate to that page before generating the embed link.
  6. Ensure that the Embed Code option is selected. The iframe code appears in the text area below.
  7. (Optional) Adjust the size of the iframe using the width and height controls
  8. Click COPY TO CLIPBOARD
    You must use the link generated by this dialog. You can't embed a report using the standard shareable link.
  9. Edit the HTML source of the page in which you want to embed the report. Paste the iframe code where you want the report to appear.

Embed in the new Google Sites

You can embed a Data Studio report in Google Sites using the Embed URL option:

  1. Follow steps 1 through 5 above.
  2. Select Embed URL.
  3. Click COPY TO CLIPBOARD.
  4. Edit your Google Site.
  5. In the upper right, click Embed URL.
  6. Paste the URL into the Embed from the web dialog.
  7. Click INSERT.

Learn more about the new Google Sites.

Embed using oEmbed

oEmbed is a format for allowing an embedded representation of a URL on third party sites. Many popular social media platforms, such as Reddit and Medium, use oEmbed. You can easily embed a Data Studio report on these sites.

You can embed a Data Studio report Using oEmbed via the Embed URL option:

  1. Follow steps 1 through 5 above.
  2. Select Embed URL.
  3. Click COPY TO CLIPBOARD.
  4. In the target site, paste the URL you just copied as the embedding URL.
Embed.ly is a popular embedding service that uses the oEmbed format. You can share your Data Studio reports on any of their client platforms.

Turn embedding off

To stop displaying an embedded report:

  1. Edit the report.
  2. Select File > Embed report, or in the upper right, click Embed.
  3. Uncheck Enable embedding.

You'll still be able to view the report in Data Studio, but it will no longer appear in embedded sites.

 

Was this article helpful?
How can we improve it?