Private Embedding

On this Page
Docs Menu

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:

    https://mycompany.looker.com/looks/4
                                ^^^^^^^
                                change to /embed/looks/
    
  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:

    https://mycompany.looker.com/explore/my_model/my_explore?...
                                ^^^^^^^^^
                                change to /embed/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:

    https://mycompany.looker.com/dashboards/1
                                ^^^^^^^^^^^^
                                change to /embed/dashboards/
    
  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.

Customizing the Appearance of Embedded Dashboards

You can adjust how a dashboard will look when it is embedded. To do so, choose Edit Embed Settings from a dashboard’s gear menu:

You can then adjust several settings:

  1. Choose to show or hide the dashboard’s title or filters
  2. Click on the color boxes to adjust the color of the dashboard elements
  3. Click Save to save your changes

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.

Still have questions?
Go to Discourse - or - Email Support
Top