Embedding a Looker Studio Report in an iframe

Learn how to Embed Looker Studio reports in an iframe and control access, permissions, and behavior. Understand limits and fix common embedding issues.

Access, Sharing & Distribution

What is a Looker Studio iframe embed?

Embedding is one of the simplest ways to display Looker Studio insights outside the Looker Studio interface. Instead of sharing a report link, you can place the report directly inside a website, intranet, client portal, or internal application using an HTML iframe.

Embedding is especially useful when dashboards need to be consumed where users already work, rather than accessed as a separate reporting tool.

This guide walks you through:

  • embedding a Looker Studio report using an iframe
  • understanding embed behavior and permissions
  • controlling access
  • common errors, limits, and troubleshooting
Looker Studio embed report window showing enabled embedding options and the iframe embed code ready to be copied.

Prerequisites

Before embedding a report, make sure:

  • You have access to the report

You must be able to view the report to generate embed code.

  • Embedding is allowed on the report

Report owners can enable or disable embedding. If disabled, the embed option will not be available.

  • You understand the access model

Embedding does not bypass permissions. Private reports still require viewers to have access.

  • Your website or app supports iframes

Embedding relies on the HTML <iframe> element.

Why embed a Looker Studio report (iframe)?

Even though Looker Studio is built for live dashboards, embedding becomes essential when you want to:

  • show dashboards inside a client portal or internal tool
  • publish analytics inside an intranet or documentation site
  • keep insights visible without asking users to open Looker Studio

Embedding is typically used when dashboards need to be continuously available, not just consulted occasionally.

How to embed a Looker Studio report in an iframe

Use case

Use iframe embedding when:

  • you want to display a report inside a web page or application
  • users should be able to interact with filters and navigation directly within the page

Steps

  1. Open the Looker Studio report you want to embed.
  2. Open the report menu and access the Embed report option.
  3. Enable embedding if it is not already enabled
Looker Studio acquisition page showing a Google Analytics 4 dashboard with sessions metrics, landing page filter, and sessions by channel and source sections in view mode.
  1. Select Embed code (iframe).
  2. Copy the generated iframe HTML.
  3. Paste the iframe code into your website or application HTML.
  4. Load the page and test access as:
    • an authorized user
    • an unauthorized user (to confirm access control)

💡 Important: Always use the embed code generated by Looker Studio. Do not reuse the standard share link inside an iframe.

Example

Beside, you can see one of Catchr Looker Studio template inside an embed iframe. You can get this Google Analytics 4 Looker Studio template for free.

Embed options and behavior

  • Interactive by default

Embedded reports retain interactivity, including filters and page navigation, based on report settings.

  • Public vs private embedding

Public reports can be viewed by anyone with the embed. Private reports still require viewers to be authorized.

  • Responsive behavior

Frame size and responsiveness depend on how the container is styled in your page layout.

  • Size editing

You can edit the size of your embed iframe to fit your needs

Looker Studio embed report dialog showing enabled embedding settings and the iframe code with copy to clipboard option.

Controlling & limiting access

Embedding does not override Looker Studio permissions.

Access is controlled by:

  • report sharing settings
  • data source permissions
  • whether the report is public or restricted

If a user does not have access to the report or its data sources, the embedded report will not display correctly.

If your requirement is to restrict access strictly within your own portal, be aware that iframe embeds still rely on Looker Studio’s permission model.

Errors & limits

Embedding has a few important limitations:

  • No row-level security per embed

You cannot apply different filters per user within a single embedded report without duplicating the report.

Troubleshooting

  • The report doesn’t appear in the iframe

Check that embedding is enabled and that you used the generated embed code.

  • The iframe is cropped or has large empty space

Adjust the iframe height or use a responsive container.

  • Some users can see the embed and others can’t

Verify report and data source permissions for each user.

  • The embed works when public but not when restricted

This is expected behavior. Restricted embeds still require authorized access.

Conclusion

Embedding a Looker Studio report in an iframe is a powerful way to integrate analytics directly into websites, portals, and applications. The key is to enable embedding, use the generated iframe code, and respect Looker Studio’s permission model.

Use iframe embedding when dashboards need to live inside workflows, not behind separate reporting links. When set up correctly, embedding turns Looker Studio into a seamless part of your product or internal tools.