Troubleshooting embed setup

This document describes how to troubleshoot issues with setting up Looker embedding. If your embedded content fails to load, there are several possible reasons to check.

Decision tree

Use the following decision tree to troubleshoot embed setup issues:

Troubleshooting steps

The following sections describe the scenarios in the tree in further detail.

Is this signed embedding?

See the Signed embedding documentation for more information about signed embedding.

If you're using signed embedding, proceed to Does private embed work?. If you aren't using signed embedding, see Third-party cookie issue.

Does private embedding work?

Check whether private embedding works.

If private embedding works, proceed to Signed embedding troubleshooting. If private embedding doesn't work, see Third-party cookie issue.

Check the domain of the embedded platform and the domain of the embed URL. If the base domains don't match, the issue may be caused by third-party cookies being blocked by the browser.

For example, if your embed application is hosted on example.com but your Looker instance URL used for embedding is customer.cloud.looker.com, browsers may block cookies from customer.cloud.looker.com when the Looker iframe is embedded in example.com. If your Looker instance was instead on looker.example.com, cookies would be first-party as base domain example.com matches.

If the issue is caused by third-party cookie denial, you can either enable third-party cookies in your browser or use cookieless embedding. If you have a Looker (Google Cloud core) instance, you can configure a custom domain so that your instance domain matches the base domain of the embedding application.

Troubleshooting signed embedding

If you're experiencing issues with signed embedding, see the Troubleshooting signed embed 404s, permissions, and content access page.

Final review and support

If the embedded iframe is still failing to load, review the troubleshooting steps on this page. If you still need help, gather the following information before you contact Support:

  • A HAR file from a network capture taken while reproducing the embed issue
  • The type of embedding being used: Public, Private, or Signed
  • When the issue started occurring