home User Guide Getting Started Help Center Documentation Community Training Certification
menu
close
settings
Looker keyboard_arrow_down
language keyboard_arrow_down
English
Français
Deutsch
日本語
search
print
Private embedding

In addition to public embedding, you can also embed Looks, Explores, and dashboards privately, so that a Looker login is required. If a user is not authenticated, you have the option to show an error message or display a login screen.

Users who are logged in and accessing privately embedded content are subject to the settings in the Sessions Admin panel, which determine how long they can stay logged in, if they can log in from multiple browsers, and if they will be logged out after a period of inactivity.

If you require a more advanced or customizable embedded solution, check out our Single sign-on (SSO) embedding documentation page.

Embedded content always reflects the production version of the content. Any changes made while in Development Mode that affect content and that have not been deployed to production will not appear in an embed.

Embedding a Look

Follow these steps to embed a Look’s visualization:

  1. Open a saved Look.
  2. Copy the URL.
  3. Change /looks/ to /embed/looks/ in the URL. For example, this:

    https://instance_name.looker.com/looks/4
    

    changes to:

    https://instance_name.looker.com/embed/looks/4
    
  4. Place your new URL into an iframe. For example:

    <iframe
      src="https://instance_name.looker.com/embed/looks/4"
      width="600"
      height="300"
      frameborder="0">
    </iframe>
    
  5. Embed the iframe as desired.

Embedding an Explore

Follow these steps to embed an Explore’s visualization:

  1. Choose Explore from Here from a saved Look, or navigate to the Explore page and create the desired visualization.
  2. Copy the URL from the Explore page. Or, if you want to modify or add URL parameters, choose Share from the gear menu in the upper right and then copy the Expanded URL.
  3. Change /explore/ to /embed/explore/ in the URL. For example, this:

    https://instance_name.looker.com/explore/my_model/my_explore?...
    

    changes to:

    https://instance_name.looker.com/embed/explore/my_model/my_explore?...
    
  4. Place your new URL into an iframe. For example:

    <iframe
      src="https://instance_name.looker.com/embed/explore/my_model/my_explore?..."
      width="1000"
      height="1000"
      frameborder="0">
    </iframe>
    
  5. Embed the iframe as desired.

Embedding a dashboard

Follow these steps to embed a dashboard:

  1. Open a saved dashboard.
  2. Copy the URL.
  3. For a dashboard that uses the new dashboard experience, change /dashboards-next/ to /embed/dashboards-next/ in the URL. For a legacy dashboard, change /dashboards/ to /embed/dashboards/ in the URL. For example, this:

    https://instance_name.looker.com/dashboards-next/1
    

    changes to:

    https://instance_name.looker.com/embed/dashboards-next/1
    

  4. Place your new URL into an iframe. For example:

    <iframe
      src="https://instance_name.looker.com/embed/dashboards-next/1"
      width="1000"
      height="2000"
      frameborder="0">
    </iframe>
    
  5. Embed the iframe as desired.

Changing the embedded appearance of a dashboard

Viewing a dashboard with /embed in the URL shows you how the dashboard will appear when it’s embedded. For a legacy dashboard, you can also select Preview Dashboard from the dashboard’s gear menu to see how your dashboard will appear when it’s embedded.

By default, an embedded dashboard is displayed using the default theme for your Looker instance. You can change the appearance of your embedded dashboard in several ways, depending on the type of dashboard you are using:

Using the theme URL argument, the Edit Embed Settings option, or the embed_style parameter makes changes only to the dashboard the argument, option, or parameter is applied to. If you want to customize the appearance of multiple embedded dashboards, use a theme instead.

Some display settings override others. For more information, see the Creating and applying themes for embedded dashboards and Explores documentation page.

Legacy Dashboard Embed Settings

The embed settings for a legacy dashboard will be overridden by any non-default theme specified in the dashboard’s embed URL, or by any individual theme elements specified in the URL.

To configure the way a legacy dashboard is displayed when it’s embedded:

  1. Click the dashboard’s gear menu and select Edit Embed Settings. This opens an embed settings pane:

  2. Choose to show or hide the dashboard’s title or filters.
  3. Click on the color boxes to adjust the color of the dashboard elements.
  4. Optionally, you can click Undo Changes to go back to the last saved embed settings for the dashboard, or you can click Reset to Defaults to change all settings back to the default settings that are used for all embedded dashboards on your Looker instance.
  5. Click Save to save your changes or Cancel to close the window without saving changes.

Removing embed settings for a legacy dashboard

If you want to remove special embed settings for a legacy dashboard:

  1. Click the dashboard’s gear menu and select Edit Embed Settings to open the embed settings pane.
  2. Click Reset to Defaults.
  3. Click Save.

Enable login screen for private embeds

You can add the parameter allow_login_screen=true to your embed URL if you want to display a login screen to users who haven’t logged in already. For example:

<iframe src="https://instance_name.looker.com/embed/looks/4?allow_login_screen=true"></iframe>
                                                            ^^^^^^^^^^^^^^^^^^^^^^^

If you do not add this parameter, a 401 error will be displayed to users who are not already logged in.

Using same-origin protections for your Looker login pages might prevent you from enabling a login screen for private embeds.

Top