This documentation page describes Looker’s legacy dashboards. Upgrade to the new Looker dashboards for faster performance; a fresh, modern look and feel; and customizable, user-friendly filters.
Once you’ve navigated to a Look or dashboard of interest, you can view and make non-permanent changes to that content, like filtering the data or changing a time zone. As long as you do not save your changes, you can view and modify legacy dashboards and Looks without impacting anyone else.
This documentation page explains how to use a legacy dashboard in other ways, such as downloading a legacy dashboard or using a legacy dashboard to start exploring your own related questions. See the Viewing Looks documentation page for a similar overview on viewing Looks. Learn more about browsing and exploring data before starting to edit Looks or edit legacy dashboards.
Legacy Dashboard Introduction
A legacy dashboard is a collection of visualizations, text, and queries that are displayed like tiles together on one page:
Dashboards can be made up of tiles based on text, saved Looks, or queries specific to that dashboard.
To view a legacy dashboard, navigate to the folder that contains the legacy dashboard and click on the legacy dashboard’s name (as shown in this section below). To learn more about editing and managing your own legacy dashboard, see our Editing Legacy Dashboards documentation page.
Opening a Saved Legacy Dashboard
To open a saved legacy dashboard:
- Click the Browse menu.
- Navigate to the appropriate folder or page.
- Click the legacy dashboard name to open it.
Switching Between Legacy Dashboards and Dashboards
Depending on your permissions and the settings your Looker admin has applied to your Looker instance, you can switch between legacy dashboards and new dashboards through the dashboard menu or the dashboard URL.
Upgrading Legacy Dashboards
You can upgrade a legacy dashboard permanently through the dashboard gear menu or temporarily by changing the dashboard URL.
Upgrading via the Dashboard Menu
If you have the Manage Access, Edit access level to edit a legacy dashboard, you can upgrade it through the gear menu in the top right corner of the dashboard. Select Upgrade Dashboard. This menu option changes the default display of the dashboard.
Upgrading via the URL
If you don’t have the Manage Access, Edit access level for a legacy dashboard, you can temporarily upgrade it by adding ‑
dashboards in the dashboard URL. A URL with ‑
dashboards shows the upgraded dashboard version:
Reverting Dashboards to Legacy Dashboards
You can revert a dashboard to a legacy dashboard permanently through the three-dot dashboard menu or temporarily by changing the dashboard URL.
Reverting via the Dashboard Menu
If you have the Manage Access, Edit access level to edit a dashboard and your Looker admin has enabled the Revert to Legacy Dashboards legacy feature, you can revert it to the legacy dashboard style through the three-dot dashboard menu in the top right corner of the dashboard. Select Revert to legacy dashboard. This menu option changes the default display of the dashboard.
If you don’t see this menu option, check with your Looker admin about your content permissions or about whether the legacy feature is enabled.
Reverting via the URL
If you don’t have the Manage Access, Edit access level for a dashboard, or if your Looker admin has not enabled the Revert to Legacy Dashboards legacy feature, you can temporarily revert a dashboard to the legacy style by removing ‑
dashboards in the dashboard URL. If you remove the ‑
next, you see the legacy dashboard version:
Upgrading and Reverting LookML Dashboards
When you select Upgrade Dashboard or Revert to legacy dashboard from the dashboard menu of a LookML dashboard, Looker displays a window with instructions on how to upgrade or revert the LookML for the dashboard. The window also allows you to copy the LookML you need to make the switch.
To upgrade or revert, you must have
develop permission and edit the LookML file the dashboard is based on. The
preferred_viewer parameter in the LookML file configures how the dashboard is rendered. To upgrade, add
preferred_viewer to the dashboard file header and give it a value of
dashboards-next. To downgrade, give
preferred_viewer a value of
Making Temporary Changes to a Legacy Dashboard
You can make some types of temporary changes to a legacy dashboard without affecting anyone else, such as changing the time zone. If your legacy dashboard has filters, you can also change the filter values to restrict the dashboard to certain types of data.
To save these changes so that they are apparent to other users, see the Editing Legacy Dashboards documentation page.
Changing Legacy Dashboard Filter Values
Looker legacy dashboards can have one or more filters that affect one or more of the tiles. For an overview of the kinds of filters available in Looker, see the Filtering and Limiting Data documentation page.
On the legacy dashboard, you can change filter values to see how the data changes. You will not affect anyone else by changing the filter unless you edit and save the dashboard. If one or more tiles do not update when you change the filter value, the filter may not apply to those tiles unless the dashboard is edited.
For example, legacy dashboards often have a filter that specifies the number of days to include. Click the Filter section to see the filter:
Then you can use the drop-down menus to change the filter choices as desired:
In the drop-downs, one of the choices is matches (advanced), which enables you to use advanced filtering choices.
Another choice in the drop-downs is matches a user attribute, which enables you to customize a legacy dashboard for each user that views it.
Configuring a Legacy Dashboard Time Zone
The time zone applied to your legacy dashboard can affect the results shown, due to slight differences in the exact hours used for time-based data. Because of this, you may want to change the time zone of your dashboard if you are interested in the data as it applies to a different region.
If your admin has enabled the User Specific Time Zone setting, you can use the time zone drop-down menu to specify the time zone in which a legacy dashboard is run:
You can choose one of the following options:
- Each Tile’s Time Zone to have all tiles run in the time zone in which they were saved
- Viewer Time Zone to have all tiles run in the time zone selected in your account settings
- Any of the time zones listed in the drop-down to have all tiles run in that time zone
Once you navigate away from the legacy dashboard, your time zone will return to the default time zone assigned to your Looker account.
If a dashboard time zone is set to Each Tile’s Time Zone and any tiles in the dashboard do not use your default time zone, which is set in your account settings, a clock icon appears in the upper right of the tiles. Hover over the clock icon to see the time zone the tile is using.
Refreshing Data in a Legacy Dashboard
Looker legacy dashboards aren’t static snapshots of data from a specific time. Looker dashboards pull data from your live database when you load the page. Typically, Looker has access to the data as fast as the data reaches the database.
If your Looker admin has enabled the Instant Dashboards Labs feature, the legacy dashboard will load immediately based on the data that was pulled the previous time the legacy dashboard was run. It will run new queries in the background and update the legacy dashboard tiles as they are completed. If you are wondering whether you are looking at fresh data or not, you can look at the top right corner of the tile; a spinner icon means that a new query is running, which in turn means that the tile will update when the query finishes.
The top right of your legacy dashboard shows how recently the data was retrieved:
If you want to get fresh data, click the gear icon in the upper right and select Clear Cache & Refresh to rerun the queries for all tiles on the legacy dashboard. If you want to refresh a specific legacy dashboard tile, click the three-dot icon and choose Clear Cache & Refresh.
Frequently using the Clear Cache & Refresh option on a legacy dashboard with many tiles, or very large reports, can cause a strain on your database. You can check the age of the legacy dashboard’s data to the left of the Run button to see if the refresh is truly needed.
Delivering Legacy Dashboards
You can send immediate or recurring deliveries — also known as schedules — of your legacy dashboard to email recipients or to other destinations. See the Using the Looker Scheduler to deliver content and the Delivering legacy dashboards documentation pages for more information.
Downloading a Legacy Dashboard
To learn about downloading data from your legacy dashboard or one of its tiles, visit the Downloading content documentation page.
Opening a Tile’s Look
For tiles based on Looks, you can see the Look that generated the tile by selecting View Original Look from the tile’s three-dot menu:
Exploring the Data Used in a Legacy Dashboard
Dashboards are also starting points for further exploration. If given permission by your Looker admin, you can click the title of a tile to explore its underlying data, or you can select Explore From Here from the tile’s menu:
Once you arrive at the Explore page, you can continue to adjust the query for your particular interest.
You also can click or hover on some elements in the legacy dashboard tiles (such as a slice of a pie chart) to view more details about the data. You can learn the skills to explore the details of a dashboard’s data on the exploring data pages.
Using Links and Actions
The presence of links or actions are indicated by three periods following the data in a field.
In some cases, your Looker developers may have added clickable links to your data:
When you click on the data in the field, Looker provides an option to open the destination of the link. In the example above, the developers added a link to the Brand column. When you click on a brand listing, Looker provides an option to perform a Google search for that brand name.
Using Data Actions
Your Looker developers may have added data actions to the dimensions or measures in your data. With data actions, you can perform tasks with other tools directly from Looker, such as sending an email or setting values in other applications. These data actions appear in the drill menu under an Actions heading:
In the example above, the Phone field has a Twilio action. When you click the phone number and select the Twilio action, a Twilio pop-up prompts you to enter a message. Then Twilio sends that message to the phone number.
When exploring a legacy dashboard, you can navigate to other items within the same folder by using the drop-down in the upper left.
Viewing Visualizations on Mobile Devices
If your Looker admin has enabled the Mobile App Integration Labs feature, you can view legacy dashboards in the Looker (beta) mobile application. To learn more, visit the Looker (beta) mobile application documentation pages.
When you’re viewing a legacy dashboard tile visualization on a mobile device, Looker has the following touch options to make it easier to view information about your data:
- Tap a data point on the visualization to show information about that data point.
- Press and hold a data point to drill into the data behind the data point.
- Press and drag across the visualization to show information about each data point as you move over them.