User Guide Getting Started Help Center Documentation Community Training
Looker
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).

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

Embedding a Look

To embed a Look’s visualization you should follow these steps:

  1. Load 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

To embed an Explore’s visualization you should follow these steps:

  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

To embed a dashboard you should follow these steps:

  1. Load 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 override any theme applied to the dashboard, including the default theme, or any custom theme that is specified in the URL of the embedded dashboard.

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

When you specify embed settings for a dashboard, the embed settings will override any theme applied to the dashboard, including the default theme, or any custom theme that is specified in the URL of the embedded dashboard.

If you want to use a theme for a dashboard instead of the embed settings, you can remove the embed settings by doing the following:

  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.

Top