home User Guide Getting Started Help Center Documentation Community Training Certification
menu
close
settings
Looker keyboard_arrow_down
language keyboard_arrow_down
English
Français
Deutsch
日本語
search
print
Looker documentation will be moving to cloud.google.com in mid-2022!
All the information you rely on will be migrated and all docs.looker.com URLs will be redirected to the appropriate page.
Viewing embedded content

With Powered by Looker (PBL), Looker’s embedded analytics functionality, Looker developers can display Looks, Explores, query visualizations, dashboards, and legacy dashboards in any HTML-formatted web page, portal, or application. You might encounter this embedded content on a public website or behind a login.

Depending on the permissions your Looker admin has assigned and the type of content you are viewing, an embedded Look, dashboard, or legacy dashboard may have options that let you interact with your data in various ways. In the case of an embedded query visualization, you will only have the option to interact with the visualization; there will not be options to interact with your data.

Viewing embedded Looks or Explores

The following options may appear at the top right of an embedded Look or Explore, depending on the permissions and content access you have been given:

  1. The Time Zone drop-down lets you change the time zone in which you view time-based data.
  2. The Run button lets you run or re-run the query. This is often useful after you make a change to the Look or Explore, such as selecting a different time zone. In those circumstances, the icon turns blue.
  3. The gear menu shows options that let you do things such as send or schedule a delivery of your data, download your data, edit the Look or use it as a starting point to further explore your data, or save the Explore to a dashboard or as a Look.
  4. The folders menu lists the folders where you can view and save Looks.

Viewing embedded dashboards

The following options may appear at the top right of an embedded dashboard, depending on the permissions and content access you have been given:

  1. Clicking the circular reload data icon updates the data on the dashboard. This is often useful after filters have been changed, added, or removed. In those circumstances, the icon is encircled by a blue halo.
  2. The three-dot menu shows options that let you do things such as edit the dashboard, revert the dashboard to a legacy dashboard, download your data, send or schedule a delivery of your data, temporarily change the dashboard time zone, or move the dashboard to the Trash folder.
  3. The folder icon lets you view the folders and the Looks and dashboards they contain that you have permission to view.

You may also see the following icons at the top right of each dashboard tile:

  1. The bell icon lets you create or follow an alert on the tile. A numeric indicator will show how many alerts you are permitted to view on that tile.
  2. The three-dot icon lets you interact with the data specific to that tile, so you can further explore the tile’s data, download the tile’s data, or, in some cases, view the Look that was the source of the tile.
  3. A globe icon appears if the tile has a different time zone than the default dashboard time zone and your default time zone. This can only happen when your Looker admin has enabled User Specific Time Zones and the dashboard time zone is set to Each tile’s timezone. Hover over the globe icon to see the time zone the tile is using.

If the embedded dashboard is in edit mode see the Editing user-defined dashboards documentation page for options. However, some editing options may not be available in the embed environment.

Viewing embedded legacy dashboards

The following options may appear at the top right of an embedded legacy dashboard, depending on the permissions and content access you have been given:

  1. The time zone drop-down lets you change the time zone in which you view time-based data.
  2. The Edit button lets you edit the dashboard.
  3. The gear menu shows options that let you do things such as send or schedule a delivery of your data, download your data, or move the dashboard to the Trash folder.
  4. The folders menu lists the folders where you can view and create dashboards.

You may also see the following icons at the top right of each dashboard tile:

  1. The bell icon lets you create or follow an alert on the tile. A numeric indicator will show how many alerts you are permitted to view on that tile.
  2. The three-dot icon lets you interact with the data specific to that tile, so you can further explore the tile’s data, download the tile’s data, or, in some cases, view the Look that was the source of the tile.
  3. A clock icon appears if your Looker admin has enabled User Specific Time Zones, the dashboard time zone is set to Each tile’s timezone, and the tile has a different time zone than your default time zone. Hover over the globe icon to see the time zone the tile is using.

Viewing embedded query visualizations

When viewing an embedded query visualization, you will see only the visualzation:

You may be able to hover over elements in the visualization to view details, but you won’t be able to interact in other ways with your data, such as further exploring or downloading your data.

Using embedded folders to find Looks and dashboards

In Looker, folders are used to store and organize your Looks and dashboards.

Viewing folders on embedded dashboards

In Looker, folders are used to store and organize your Looks and dashboards. If you see the folders icon ( ), you can click it to view any folders, along with the Looks and dashboards contained there, that you have permission to view:

To view any content, click the name of the Look or dashboard.

In addition to Looks and dashboards, in your folders you might see subfolders:

Click on a subfolder to navigate to it and view any content or additional subfolders stored there.

Copying, moving, and deleting content on embedded dashboards

If your Looker administrator has enabled the Embed Content Management Labs feature and you have been granted the necessary permissions, you can copy or move dashboards and Looks into different folders, or you can delete a dashboard or Look by moving it into the Trash folder.

To copy content:

  1. Navigate to the folder that contains the dashboard or Look you want to copy, and then click the three-dot menu next to the content and select Make a copy:

    You’ll see a message indicating that you are copying the selected content and the option to Copy Here:

  2. If you want to store the copy of the selected content in the same folder as the original, click Copy Here.

    If you want to create a copy of the content in a different folder, navigate to the folder where you want to store the copy of the content you selected, and then click Copy Here.

    You’ll see a copy of the selected content appear, using the name of the original content and the text (copy) appended to the content name. There is not an option to rename the copied content from within an embedded dashboard.

To move content:

  1. Navigate to the folder that contains the dashboard or Look that you want to copy, and then click the three-dot menu next to the content and select Move to:

    You’ll see a message indicating that you are moving the selected content:

  2. Navigate to the new folder where you want to store the content you selected, and then click Move to.

    You’ll see the selected content appear in the new folder.

To delete content:

  1. Navigate to the folder that contains the dashboard or Look that you want to delete, and then click the three-dot menu next to the content and select Move to trash:

    You will be asked to confirm whether you want to move this content to the trash.

  2. On the confirmation screen, click Move to trash.

Viewing folders on embedded Looks and legacy dashboards

If you see the folders menu ( ), you can click it to view any folders, along with the Looks and dashboards contained there, that you have permission to view:

  1. The single-person icon denotes your personal folder, where you can store Looks or dashboards that only you can access.
  2. If your Looker admin has added you to an external group of users, a two-person icon denotes your Group folder. Here you can view and store content that your entire group can access.
  3. The wireframe globe icon denotes the Shared folder. Looks and dashboards stored here are available to anyone who has access to the Shared folder.

To view any content, click the name of the Look or dashboard.

In addition to Looks and dashboards, in your folders you might see other folders:

Click on a folder to navigate to it and view any content or additional subfolders stored there.

Interacting with an embedded Look, Explore, or dashboard

The Look, Explore, or dashboard menu and the three-dot icon on dashboard tiles give you a number of options for modifying and interacting with your Look, Explore, or dashboard. You might see all, some, or none of these options, depending on the permissions your Looker admin has assigned and your access to the content you are viewing. These options are:

Top