Private Embedding

On this Page
Docs Menu

In addition to public embedding, you can also embed Looks and dashboards privately, so that a Looker login is required. If a user is not authenticated you have the option to show a “permission denied” type of message, or to display a login screen (instructions below).

Embedding a Look

To embed a Look you should follow these steps:

  1. Load a saved Look, or create the desired visualization, so that you are viewing it in the Explore page.
  2. Copy the URL from the explore page.
  3. Change /explore/ to /embed/query/ in the URL, for example:

    https://mycomp.com/explore/my_model/my_explore?...
                      ^^^^^^^^^
                      change to /embed/query/
    
  4. Place your new URL into an iframe, for example:

    <iframe
      src="https://mycomp.com/embed/query/my_model/my_explore?..."
      width="600"
      height="338"
      frameborder="0">
    </iframe>
    
  5. Embed the iframe as desired.

Embedding a Dashboard

To embed a dashboard you should navigate to the desired dashboard and copy its URL. Then, add /embed/ to the URL after the domain and before /dashboards/. For example:

https://yourcompany.looker.com/embed/dashboards/my_model/my_dashboard
                              ^^^^^^^

https://yourcompany.looker.com/embed/dashboards/32
                              ^^^^^^^

Then, place this URL into an iframe:

<iframe
  src="https://yourcompany.looker.com/embed/dashboards/32"
  width="600"
  height="338"
  frameborder="0">
</iframe>

Finally, embed the iframe as desired.

If you require a more advanced or customizable embedded solution (e.g. SSO with passive login), please contact your Looker account manager.

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://mycomp.com/embed/query/my_model/my_explore?...&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