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. You can see the filter by clicking the Filter section:
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 your user’s legacy dashboard setting.
- 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.
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.
Scheduling Legacy Dashboard Data Delivery
Looker lets you schedule periodic delivery of your legacy dashboard to email recipients or to other destinations. See the Scheduling Data Deliveries documentation page for more information.
Sending Your Legacy Dashboard Immediately
Looker lets you send a legacy dashboard immediately in an email to yourself or other people, or send the results to another destination. See the Sending Data Now documentation page for details.
Downloading Your Legacy Dashboard
Looker admins can see important information about downloading dashboards on this documentation page.
Looker lets you download your legacy dashboard so that you can store or share the current data. You can download the legacy dashboard as a zipped collection of CSV files or as a PDF.
Downloading Your Legacy Dashboard as CSV Files
- Click the gear icon in the upper right-hand corner of the page.
- Select Download as CSVs to begin the download.
The zipped directory will have a separate CSV file for each dashboard tile. Each CSV file includes the formatted data used to create the tile in the dashboard:
Downloading Your Legacy Dashboard as a PDF
If your Looker admin has given you download permissions, you can also download your legacy dashboard in PDF format:
Certain downloading options require that admins of customer-hosted Looker deployments have installed the appropriate version of the Chromium renderer. Admins can read more about rendering image-based data formats when sending and scheduling dashboards, Looks, or Explores on the Managing business user features documentation page.
- Click the gear icon in the upper right-hand corner of the page.
- Select Download as PDF.
- Optionally, use the Filename box to change the name of the PDF file.
Optionally, expand the Advanced options menu to further customize your PDF.
Then check the Single column format box if you want the PDF to show the legacy dashboard tiles in a single vertical column. Leave the box unchecked if you want the PDF to show the tiles as they are arranged in the legacy dashboard.
You also have the option to specify the optimal size and orientation of your PDF by selecting from the Paper size drop-down menu. Large visualizations or groups of overlapping dashboard tiles may need to be resized to fit cleanly on a PDF page. If you do not see the Paper size option, talk to your Looker admin about installing the appropriate version of the Chromium renderer for your Looker instance.
For Looker developers, downloads in PDF format always pull from the model as it is in Production Mode, even when you are in Development Mode.
Downloading Data from Legacy Dashboard Tiles
To download the data from a specific tile, click the three-dot icon and select Download Data:
See the Downloading data documentation page for more information about the options available to customize your data download.
For legacy dashboard tiles based on merged results queries, you can’t download the data itself, but you can download the legacy dashboard as a PDF or as a collection of CSV files.
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.