In Looker 21.20, Looker upgraded the default dashboard experience for all users to the new dashboard experience. As part of that effort, we introduced a change to dashboard and legacy dashboard URL routing:
| Dashboard type | URLs in Looker 21.18 and earlier | URLs in Looker 21.20 and later |
| Dashboards (i.e., the new dashboard experience) | https://instance.looker.com/dashboards-next/1 | https://instance.looker.com/dashboards/1 |
| Legacy dashboards | https://instance.looker.com/dashboards/1 | https://instance.looker.com/dashboards-legacy/1 |
This change does not break any links or bookmarks to dashboards.
Any links or bookmarks that use /dashboards-next/ now automatically
redirect to dashboards/. Any links or bookmarks to
/dashboards/ now redirect to the new dashboard experience, as opposed
to legacy dashboards.
When you are navigating within Looker, any dashboards that have not been reverted to legacy dashboards will now default to the new dashboard experience.
For customers who adopted Looker on or after Looker 7.18 (October 2020)
For user-defined dashboards, your instance already defaults to the new dashboard experience, and dashboards will continue to appear as your users have created them. Any dashboards that were legacy dashboards before Looker 21.20 will remain legacy dashboards after Looker 21.20.
For LookML dashboards and dashboards that were created with the API, if the dashboards have
no preferred_viewer parameter set, they will be upgraded to the
new dashboard experience. To keep them as legacy dashboards, set the
preferred_viewer parameter to dashboards.
Embedded dashboards will also be upgraded to the new dashboard experience. To
keep them as legacy dashboards, update their URLs to contain
/embed/dashboards-legacy/.
For customers who adopted Looker before Looker 7.18 (October 2020)
Note: The Removing the legacy dashboard experience - a timeline from Looker 21.20 (November 2021) through Looker 23.6 (April 2023) Best Practices page contains updated information about Looker dashboard behavior upon update to Looker 22.20 and 23.6.
As of Looker 21.20, dashboards on your instance will default to the new dashboard experience, unless they have been reverted to legacy dashboards.
Any dashboards that use the following configurations will continue to appear as legacy dashboards:
- User-defined dashboards that have been reverted to legacy dashboards
-
LookML dashboards that have a
preferred_viewerparameter set todashboards -
Dashboards created with the API that have a
preferred_viewerparameter set todashboards
Any dashboards that use the following configurations will be upgraded from legacy dashboards to dashboards:
- User-defined dashboards that have not been reverted to legacy dashboards
-
LookML dashboards with newspaper layout that have no
preferred_viewerparameter set -
Dashboards that were created through the API and that have no
preferred_viewerparameter set -
Embedded dashboards that use
/embed/dashboards/in their URLs
If you want to keep particular dashboards as legacy dashboards after Looker 21.20, see the If you want to continue using legacy dashboards section on this page.
If you want to postpone the change to URL routing entirely, see the Postponing the change to dashboard URL routing section on this page.
If you want to continue using legacy dashboards
Note: As of Looker 22.20, the Use old dashboard routes and Revert to legacy dashboards legacy features have been removed. Use the Can use Legacy Dashboards legacy feature to continue to use legacy dashboards until you upgrade to Looker 23.6. See the Removing the legacy dashboard experience - a timeline from Looker 21.20 (November 2021) through Looker 23.6 (April 2023) Best Practices page for more information.
Looker plans to fully deprecate legacy dashboards in November 2022 and to remove them entirely in April 2023. Currently, we are incorporating customer feedback and adding new features to the new dashboard experience. During the transition, you can choose to continue viewing legacy dashboards.
To continue viewing legacy dashboards, there are several methods, depending on the type of dashboard.
Reverting user-defined dashboards to legacy dashboards
If you have individual user-defined dashboards that you want to keep as legacy dashboards after 21.20, you can revert them.
To revert dashboards to legacy dashboards:
- Make sure the Revert to Legacy Dashboards legacy feature is enabled.
- Follow the steps outlined on the Viewing dashboards documentation page.
The dashboard then defaults to a legacy dashboard within Looker and through external
links using dashboards-legacy/.
To temporarily revert a dashboard to a legacy dashboard while you're viewing
it, replace dashboards/ in the URL with
dashboards-legacy/. Revert to Legacy Dashboards
does not need to be enabled. This change will not be saved to the dashboard;
if you navigate to the dashboard within Looker, it will default to the new dashboard
experience.
Reverting LookML and API-created dashboards to legacy dashboards
If the preferred_viewer parameter is undefined, as of Looker 21.20,
the dashboard will appear in the new dashboard experience.
For LookML dashboards and dashboards that were created with the API, setting a dashboard's
preferred_viewer parameter to dashboards reverts the
dashboard to a legacy dashboard.
For more information about the preferred_viewer parameter, visit
the
Dashboard parameters
documentation page or the
Create Dashboard
and
Update Dashboard
API documentation.
Reverting links, bookmarks, and embedded dashboards to legacy dashboards
To revert links, bookmarks, and embedded dashboards to legacy dashboards, update
your links to use dashboards-legacy/ instead of
dashboards/.
For more information about embedded dashboard links, visit the Private embedding and Signed embedding documentation pages.
Postponing the change to dashboard URL routing
Note: As of Looker 22.20, the Use old dashboard routes Labs feature has been removed. Use the Can use Legacy Dashboards legacy feature to continue to use legacy dashboards until you upgrade to Looker 23.6. See the Removing the legacy dashboard experience - a timeline from Looker 21.20 (November 2021) through Looker 23.6 (April 2023) Best Practices page for more information.
To postpone the upgrade from legacy dashboards to dashboards for all dashboards on your instance, enable the Use old dashboard routes legacy feature. This legacy feature defaults to enabled in Looker 21.18 defaults to disabled in Looker 21.20 and is removed in Looker 22.20.