User Guide Getting Started Help Center Documentation Community Training
Looker
  
English
Français
Deutsch
日本語
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 to display a login screen (instructions below).

User who are logged in and accessing privately embedded content are subject to the settings in the Sessions admin panel that determine how long they can stay logged in, whether they can log in from multiple browsers, or whether they are logged out due to inactivity.

If you require a more advanced or customizable embedded solution check out our single sign-on embedding page.

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://mycompany.looker.com/looks/4
    

    changes to:

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

    <iframe
      src="https://mycompany.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://mycompany.looker.com/explore/my_model/my_explore?...
    

    changes to:

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

    <iframe
      src="https://mycompany.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 the steps below to embed a dashboard. You can select Preview Dashboard from the dashboard’s gear menu to see how your dashboard will appear when it’s embedded.

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

    https://mycompany.looker.com/dashboards/1
    

    changes to:

    https://mycompany.looker.com/embed/dashboards/1
    
  4. Place your new URL into an iframe. For example:

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

The embedded dashboard will be displayed using the default theme for your Looker instance. There are two ways to change the display settings from the default theme:

Changing the Embedded Appearance of a Dashboard

Using embed settings, you can adjust how a user-defined dashboard will look when it is embedded. (For embedded LookML dashboards, see the embed_style parameter.)

The embed settings apply only to the current dashboard. If you want to customize the appearance of multiple embedded dashboards, use a theme instead.

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

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

  1. Click the dashboard’s gear menu and select Edit Embed Settings.
  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 Dashboard

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

  1. Click the dashboard’s gear menu and select Edit Embed Settings.
  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://mycompany.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 may prevent you from enabling a login screen for private embeds.

Top