Adding tabs to dashboards

This page provides an overview of how to use the Tabbed Dashboards Labs feature in Looker to organize your dashboard content across multiple tabs within a single dashboard.

Dashboard tabs let you do the following:

  • Better organize content: Group related visualizations and tiles into separate tabs.
  • Improve data storytelling: Guide viewers through different aspects of your data in a structured way.
  • Enhance performance: Load only the tiles on an active tab, potentially speeding up initial dashboard load times.
  • Reduce clutter: Consolidate multiple related analyses into a single dashboard.

This page includes the following sections:

Provide feedback or get support

You can provide feedback or request support by filling out and submitting this Looker Tabbed Dashboards - Preview Issues form.

User and instance requirements

To enable and use the Tabbed Dashboards Labs feature, you must meet the following requirements:

  • Your Looker (original) instance must be running Looker 26.0 or later and be Looker-hosted.
  • You must have the Admin role to enable the Tabbed Dashboards Labs feature or to set a Maximum Dashboard Tabs limit for your Looker instance.

  • To make permanent changes to dashboards that all users will see, you must have the following access level and permissions:

  • To view dashboards, you must have the following access levels and permissions:

    Additionally, to view a specific dashboard tile, you must have access to the model that the tile is based on.

  • Optionally, users must also have the appropriate permissions to send, schedule, and download dashboards.

Limitations

The Tabbed Dashboards Labs feature has the following limitations:

  • The default maximum number of tabs is 5. Admins can set a different maximum number of tabs on the Content Guardrails Admin page.

  • Tiles on a tab will only start loading if a user clicks on the tab. For example, if a dashboard has 3 tabs and a user clicks the first and second tab, the tiles on those tabs will start loading. No tiles on tab 3 will load. Queries execute and queue in the order of the interaction. The per-user query limit still applies.

  • You cannot control user access to specific tabs.

Enable Tabbed Dashboards

Looker admins can enable the Tabbed Dashboards Labs feature by following these steps:

  1. In Looker, select the Admin option in the main navigation menu.
  2. Select the Labs option under the General section to open the Labs page.
  3. Select the Tabbed Dashboards toggle switch to enable the Labs feature.

Tabbed dashboard features for admins

When the Tabbed Dashboards Labs feature is enabled, Looker admins can choose to set set a Maximum Dashboard Tabs limit instance-wide.

To set a Maximum Dashboard Tabs limit for your instance, follow these steps:

  1. In Looker, click the Admin option in the main navigation menu.
  2. Select the Content Guardrails option under the Performance section to open the Content Guardrails page.

  3. Enter a number into the Maximum Dashboard Tabs field to set a number of maximum tabs, or use the up and down arrows to set a number.

  4. Select Save to save the setting.

Tabbed dashboard features for dashboard creators

Dashboard creators with appropriate access have the following option for adding tabs to dashboards:

Add tabs to user-defined dashboards

To add tabs to user-defined dashboards, follow these steps:

  1. Open any user-defined dashboard and switch to edit mode.
  2. Select the + Add button in the top navigation and select the Tabs option.
  3. Once a tab is created, select the Add button in the tab to add tiles.

Delete tabs

To delete tabs, follow these steps:

  1. Open a tabbed dashboard and switch to edit mode.
  2. Select the three-dot menu for a tab, and select the Delete option.

Edit tabs

You can edit tabs in the following ways:

Rename tabs

To rename a tab, follow these steps:

  1. Open a tabbed dashboard and switch to edit mode.
  2. Double-click the tab name and rename the tab.

  3. Press the Enter key (PC) or Return key (Mac) to save the name.

Reorder tabs

To change the order of tabs on a user-defined dashboard, follow these steps:

  1. Open the tabbed dashboard and switch to edit mode.
  2. Select the three-dot menu for a tab, and select the > Move right or < Move left option.

Apply filters to tiles on different tabs

To apply filters to dashboard tiles that are on different tabs, follow these steps:

  1. Open a tabbed dashboard and switch to edit mode.
  2. Select the Filters button in the top navigation, and then select Add Filter.
  3. Configure the filter settings in the Add Filter window Settings tab.
  4. Select the Tiles To Update tab and select the tiles to apply the filter. If you don't want to apply the filter to a tile, select the Do Not Filter option from the tile's drop-down menu.

Move tiles to different tabs

To move a tile to a different tab, follow these steps:

  1. Open a tabbed dashboard and switch to edit mode.
  2. Select the three-dot menu for a tile, and select the Move to tab option.
  3. Select the name of a tab to move the tile.

Apply a quick layout

Quick layouts let you apply a cohesive tile configuration to tabs on a user-defined dashboard without the need to manually resize tiles. Quick layouts are available in the following size formats:

  • XS — Six tiles fit in a row on the dashboard.
  • S — Four tiles fit in a row on the dashboard.
  • M — Three tiles fit in a row on the dashboard.
  • L — Two tiles fit in a row on the dashboard.
  • XL — One tile fits in a row on the dashboard.

To apply a quick layout to tabs on a user-defined dashboard, follow these steps:

  1. Open a tabbed dashboard and switch to edit mode.
  2. Select the Quick layout button in the top navigation.
  3. Select a size format.

The size format will apply to all the tabs on the dashboard. Tile sizes are responsive to the size of the dashboard. Quick layout affects all tiles including text tiles, visualization tiles, Markdown tiles, and buttons.

Apply autorefresh to tiles that are on different tabs

To apply autorefresh for tiles that are on different dashboard tabs, follow these steps:

  1. Open a tabbed dashboard and switch to edit mode.
  2. Select the Settings button in the top navigation.
  3. On the General tab, select the Refresh every option from the Refresh frequency menu to set a refresh interval for the individual tiles on tabs.

Tabbed dashboard features for dashboard viewers

In addition to viewing content on tabbed dashboards, dashboard viewers with appropriate permissions can interact with tabbed dashboards in the following ways:

Download tabbed dashboards as a PDF

When you download a tabbed dashboard as a PDF, all of the tabs will appear in the same PDF. The contents of each tab will be organized under a content header with the name of the tab.

To get the link for a dashboard tab, select any tab and copy the browser URL.

Alternatively, you can get the entire dashboard link by selecting the Get link option from the dashboard's three-dot menu.