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
Creating 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 use dashboards (beta). You can also switch back and forth between dashboards (beta) and Looker’s original dashboards.

For a complete list of dashboards (beta) documentation, see the Dashboards (Beta) documentation page.

Creating a Dashboard (Beta) from a Folder

Create a dashboard (beta) from a folder by:

  1. Navigating to a folder where you’d like the dashboard (beta) to be located.
  2. Clicking the New button at the top right of the folder.
  3. Clicking Dashboard (Beta).
  4. Entering a name for your new dashboard.
  5. Clicking Create Dashboard.

Next, your new blank dashboard appears. From there, you can add tiles or text by entering edit mode. Enter edit mode by selecting Edit dashboard from the dashboard menu or by clicking the Edit Dashboard button in the center of the dashboard pane.

Creating a Dashboard (Beta) from a Look or an Explore

Create a dashboard (beta) from a Look or an Explore by:

  1. Navigating to a Look or an Explore.
  2. Selecting Save to Dashboard from the gear menu.
  3. Selecting the folder in which you’d like the dashboard to be located.
  4. Clicking the New Dashboard button.
  5. Clicking Dashboard (Beta).
  6. Entering a name for your new dashboard.
  7. Clicking OK.

Next, you will see the new dashboard in your Add to a Dashboard window:

From there, you can select the new dashboard and add the query as a query tile or, if you are working from a Look, as a Look-linked tile.

If you exit the Add to Dashboard window without saving the Look or query to the dashboard, you will have still created the dashboard; it will simply be blank.

Adding Tiles and Text to a Dashboard (Beta)

Once you create a dashboard (beta), the next step is to add tiles and text to the dashboard.

As you add tiles to a dashboard (beta), Looker automatically sizes them and places them at the bottom of the dashboard, but you can move and resize tiles however you like. You can also edit tiles after you’ve created them to adjust the names of the tiles, the visualizations, or the underlying queries or Looks.

Think about the number and complexity of tiles and other elements that you add to a dashboard. More elements require more browser resources, which increases dashboard rendering time. If rendering becomes an issue, consider creating multiple dashboards with fewer elements.

Types of Dashboard (Beta) Tiles

There are three kinds of tiles you can add to a dashboard (beta):

Query Tiles

Query tiles can be built directly within a dashboard (beta) or added to a dashboard (beta) from a Look or Explore.

A query tile is based on an independent query, one that is not linked to a Look. The query underlying a query tile belongs to the dashboard. Even if you use an existing Look to create a query tile, the Look is only used during the creation of the query tile. The tile is unaffected by any later changes to that Look, and still exists on the dashboard even if the Look is deleted.

When possible, use query tiles to avoid cluttering your folders with unnecessary Looks.

Look-Linked Tiles

Look-linked tiles are added to a dashboard (beta) from a Look.

A Look-linked tile links the tile’s underlying query to a Look. That Look is used when creating the tile and every time the dashboard is refreshed. The Look and the dashboard must be in the same folder. If you would like to add Looks from a different folder, first copy the Look into the same folder as the dashboard.

A Look-linked tile is a good choice if you want to create, change, and test a query in one place but use it in multiple dashboards. If the Look changes, any tiles linked to that Look change. If the Look is deleted, dashboards show an error for the tile.

Text Tiles

Text tiles are built directly within a dashboard (beta).

You can use text tiles to define visual sections on a dashboard and to add descriptions. Text tiles in dashboards (beta) are designed to have flexible formatting and default to look more like headings and descriptions than tiles.

You can use HTML in text tiles. However, HTML in text tiles converted from original dashboards may not render as expected, especially if the HTML is referencing class names in element tags. To understand how Looker renders HTML, see the HTML Sanitization documentation page.

Building Query Tiles Within a Dashboard (Beta)

If you’re in a dashboard (beta), you can build a query tile right inside the dashboard.

Once in the dashboard’s edit mode, you can either:

Next, Looker displays a menu of Explores. Choose an Explore to build your query:

Looker opens the Explore window to let you build your query:

  1. Give your query a name. This will be the name of the tile on the dashboard.
  2. Select the fields and filters for your query.
  3. Configure your visualization options.
  4. Once you have set up your query, click Run.
  5. Click Save to save the query as a tile on your dashboard.

Adding Query Tiles from an Explore

You can save a query tile to a dashboard (beta) directly from an Explore. Once you are in an Explore with a query you want to add to the dashboard:

  1. Select Save to Dashboard from the gear menu
  2. Give your tile a title.
  3. Select the folder the dashboard is located in.
  4. Select the dashboard.
  5. Click Save to Dashboard.

Adding Query or Look-Linked Tiles from a Look

You can add both query tiles and Look-linked tiles to dashboards (beta) from a Look.

Adding Query Tiles from a Look

You can save a query tile to a dashboard (beta) directly from a Look. Once you have navigated to a Look with a query you want to add to the dashboard:

  1. Select Save to Dashboard from the gear menu
  2. When you add a query tile from a Look, the tile is given the same title as the name of the Look (which can be edited later).
  3. Select the folder the dashboard is located in.
  4. Select the dashboard.
  5. Click Save to Dashboard.

Tiles you add to a dashboard (beta) through this method are not connected to the Look you created them from. You can edit the tiles without affecting the Look. You can edit or delete the Look without affecting the tiles.

Adding Look-Linked Tiles from a Look

You can save a Look-linked tile to a dashboard (beta) directly from a Look. However, the Look and the dashboard (beta) must be in the same folder. Once you have a Look with a query you want to add to the dashboard:

  1. Select Save to Dashboard from the gear menu.
  2. When you add a Look-linked tile from a Look, the tile is given the same title as the name of the Look. If you’d like to change the title of a tile, you can edit the tile’s Look.
  3. Select the dashboard.
  4. Click Add Look to Dashboard.

Tiles you add to a dashboard (beta) through this method are connected to the Look you created them from. If you edit the tile, the Look and any other tiles linked to that Look are affected. If you edit or delete the Look, the tiles are affected.

Adding Text

Once in edit mode of a dashboard (beta), you can add text tiles by clicking Add Tile from the top left of the dashboard pane and then clicking Text.

This brings up a window where you can add a title, subtitle, and body. All of these elements are optional.

Titles and subtitles support some HTML, including links and images. Body text supports a subset of the Markdown markup language. See the Using Markdown in Text Tiles documentation page for more information about which Markdown syntax is supported in the body text.

Once you save, you will see your text tile at the bottom of the dashboard. It can then be moved and resized just as you would move and resize other tiles.

Adding Dashboard Filters to Dashboards (Beta)

The queries underlying dashboard tiles may include filters, but you can also add filters to a dashboard (beta) itself, which can affect all tiles or just select tiles. Dashboard filters allow users to narrow a dashboard’s results to only the data they are interested in.

To add dashboard filters, you must have at least one query tile or Look-linked tile on the dashboard. Then, you can add filters by entering edit mode and selecting Filters from the top toolbar:

To learn more about building standard dashboard filters, visit the Adding and Editing Dashboard (Beta) Filters documentation page.

To learn about turning on dashboard (beta) cross-filters, visit the Cross-filtering Dashboards (Beta) documentation page.

Improving Dashboard Performance Using Aggregate Awareness

LookML developers may be able to improve dashboard (beta) performance by using aggregate awareness. With aggregate awareness, developers can create aggregate tables under LookML explore parameters, which can optimize queries for one or more tiles in a dashboard. The first step is to get the aggregate table LookML, which appears under the Get LookML option in the dashboard (beta) three-dot menu. For more information, see the aggregate_table documentation page.

Top