User Guide Getting Started Help Center Documentation Community Training
Dashboards (Beta)

Dashboards (beta) are a new version of Looker dashboards that have a fresh, modern look and feel; customizable, user-friendly filters; a new dashboard creation experience and editing flow; and improved performance.

If your admin has enabled the New Dashboard Experience Labs feature, you can view, edit, and create dashboards using dashboards (beta). You can also switch back and forth with Looker’s original dashboard experience.

Switching Between Dashboards (Beta) and Original Dashboards

Dashboards (beta) exist together with Looker’s original dashboards. Our Help Center article on dashboards (beta) versus original dashboards compares the features available in each type of dashboard; you can switch a dashboard between the two different versions to take advantage of different features.

You can change between dashboards (beta) and original dashboards by using the dashboard menu or changing the dashboard URL.

Switching via the Dashboard Menu

If you have the Manage Access, Edit access level to edit a dashboard, you can switch between original and dashboards (beta) from the menu in the top right corner of the dashboard. This menu option changes the default display of the dashboard.

To Switch from an Original Dashboard to a Dashboard (Beta):

To Switch from a Dashboard (Beta) to an Original Dashboard:

Switching via the URL

If you don’t have the Manage Access, Edit access level for a dashboard, you can temporarily switch between the original version and the dashboard (beta) version of the dashboard by adding or removing ‑next after dashboards in the dashboard URL. A URL with ‑next after dashboards shows the dashboard (beta) version:

If you remove the ‑next, you see the original dashboard version:

You can return to the dashboard (beta) version of the dashboard by adding ‑next back into the URL.

Viewing Dashboards (Beta)

A dashboard is a collection of charts and text that are displayed like tiles together on one page.

Anatomy of a Dashboard (Beta)

  1. Dashboard title: The dashboard title appears at the top left of the dashboard.
  2. Dashboard filters: Dashboard filters appear below the dashboard title. They can be placed as inline, popover, or overflow filters. For popover and overflow filters, clicking on the filter value or the More button will reveal the full filter.
  3. Reload data icon: Clicking the circular arrow icon refreshes the data in each tile on the dashboard. This is often helpful after filters have been changed, added, or removed, and in those circumstances the icon pulses with a purple halo.
  4. Dashboard menu: The three-dot dashboard menu provides options to edit the dashboard, clear cache and refresh, and revert to original dashboard. If you do not have the Manage Access, Edit access level for the dashboard, you will only see the option to clear cache and refresh.
  5. Beta badge: The beta badge indicates the dashboards (beta) feature is still under active development. Clicking on the badge takes you to documentation for dashboards (beta).
  6. Dashboard last updated indicator: This indicator shows how recently the data on the dashboard was retrieved from the database. To update the data, select Clear cache and refresh from the dashboard menu.

Dashboard (Beta) Tiles

Each dashboard tile represents a query that can be explored further.

  1. If given permission by your Looker admin, you can use the bell icon to create or follow an alert on the tile. If there are public alerts on the tile, a numeric indicator will show how many.
  2. Each tile’s three-dot menu provides the option to Explore from here, which allows you to explore the tile’s data. The three-dot menu also shows when the tile’s data was last updated, if it was updated more recently than the dashboard’s last updated indicator.
  3. If given permission by your Looker admin, you can hover over some elements in the tile to view more details about the data.
  4. If given permission by your Looker admin, you can click on a data point to see the options to explore or drill based on that individual data point.

Creating Dashboards (Beta)

You can create a dashboard (beta) by clicking the New button inside a folder:

You can also create a dashboard (beta) from a Look or an Explore by selecting Save to Dashboard from the gear menu, and then clicking the New Dashboard button:

Once you’ve created the new dashboard, you can add tiles by selecting Edit dashboard from the dashboard menu or clicking the Edit Dashboard button in the center of the new dashboard landing page.

From there, you have two ways to add tiles to the new dashboard:

Editing Dashboards (Beta)

If you have the Manage Access, Edit access level for a dashboard, you can edit it. To edit an existing dashboard (beta), select Edit dashboard from the dashboard menu:

From there you enter edit mode, where you can add or edit tiles or filters, and edit the dashboard title.

Adding Tiles

To add a new dashboard tile, select Add Tile. You will then have the option to add a visualization or a text tile.

Choosing to add a visualization allows you to add a query tile to the dashboard. You can also add a chart to a dashboard (beta) directly from a Look or an Explore, by selecting Save to Dashboard from the gear menu and picking your dashboard.

Choosing to add text brings up a window where you can add and format text to be placed on your dashboard.

Using Tiles with Grid Layout

New in Looker 7.4, you can add visualizations that use grid layout to dashboards (beta).

When you add a visualization using grid layout to a dashboard (beta), the grid arrangement can become responsive to the size of the dashboard tile.

For example, say you have a dashboard tile with a visualization that uses a grid layout of four small charts. If you size the tile to be short and wide, the small charts appear as one row of four. If you size the tile as a square, the small charts rearrange to two rows of two. Or, if you size the tile to be narrow but tall, the charts rearrange to four rows of one.

To ensure that the grid arrangement is responsive, do not enter a number into the visualization's Number of Charts per Row setting. If you enter a value into Number of Charts per Row, the dashboard tile will respect that setting regardless of the size or shape of the dashboard tile.

Editing Tiles

When a dashboard (beta) is in edit mode, each tile shows several icons that allow you to edit it in various ways.

  1. Clicking and holding the six-dot icon at the top left allows you to move the tile within the dashboard.
  2. Clicking the three-dot menu reveals a drop-down with options to edit or delete the tile. Selecting Edit opens the tile’s edit window, where you can edit the tile’s title, query, or visualization.
  3. Clicking and pulling the triangle icon allows you to resize the tile.

Adding Filters

Dashboard (beta) filters cannot currently be applied to merged results tiles.

Once your dashboard contains tiles, you can add dashboard filters. When you click the Add Filter button, an Add Filter window appears pre-populated with fields from any Explores used in the dashboard. You can use the search to find the field you want to filter by, or you can select it from the drop-down menu:

After selecting the field you want to filter by, a filter configuration window appears that allows you to customize your filter settings.

  1. Title: Enter the title of the filter as you wish it to appear on the dashboard. The title option pre-populates with the name of the filter-by field.
  2. Control: Select from a list of control types, which vary depending on the type of data you are filtering.
  3. Location: Select the placement of the filter. Filters can be placed:

    • Inline: Displayed directly in the top bar of the dashboard.

    • Popover: A summary value appears in the top bar of the dashboard; click the value to see the full filter.

    • Overflow: A More button appears in the top bar of the dashboard with a numeric indicator of the number of overflow filters; click the button to see the overflow filters.

    Generally, it’s a good idea to place important or frequently used filters in inline or popover positions and less-frequently used filters in overflow positions.

  4. Values: Enter the value options for the filter.
  5. Configure Default Value: Set the default value for the filter.
  6. Add and Cancel: Click one of these buttons to save or cancel the new filter.

The Tiles to Update tab allows you to determine which tiles will be affected by the filter:

  1. Select All or None to turn the filter on or off for all tiles.
  2. In the Field to Filter section, choose which field for each tile is affected by the filter, or choose not to apply the filter to that individual tile.
  3. Select Add or Cancel to save or cancel the new filter.

Editing Filters

In edit mode, a pencil icon appears next to every filter.

To edit a filter, click the pencil icon. That opens a similar window to the one used to add a filter, populated with the existing configuration for the filter. From there, you can update the filter-by field, the filter’s settings, or the tiles to update. Select Update or Cancel to save or cancel your changes.

Click the Delete button to delete your filter entirely.

After editing filters, click the dashboard’s reload data icon to apply the new filter settings to the tiles.

Embedding Dashboards (Beta)

Dashboards (beta) can be embedded by changing the URL you use to embed from containing simply /dashboards-next to containing /embed/dashboards-next. Embedded dashboards (beta) do not currently support themes or embed settings.

To learn more about embedding dashboards, vist the Private Embedding and SSO Embedding documentation pages.