Starting in Looker 7.0, with the Looker Marketplace Labs feature enabled (as it is by default), you can install Looker Marketplace Plug-Ins, which include visualization types that you can add to Looker’s native visualization library. This method of installing custom visualizations is recommended over the method described on this page. See the Using the Looker Marketplace documentation page for more information about Marketplace Plug-Ins and visualizations.
Custom visualizations are a community-supported effort. Looker’s support team does not troubleshoot issues relating to custom visualizations or your custom visualization code. For tracking and closing out bugs, please use GitHub issues in the custom visualization’s repository, or visit Looker’s Community Forums or Help Center for how-to articles, conversations, and tips regarding custom visualizations.
You can find a list of Looker’s Viz Blocks in Looker’s Blocks Directory. Looker also maintains a library of custom visualizations for public use on GitHub. You can find instructions for using Looker’s Visualization API to create your own visualization types here.
Viewing a List of Custom Visualizations
The Visualizations page lists all of the custom visualizations that have been added to your Looker instance:
The list includes the following columns:
- Label: The name given to the visualization type in the Looker visualization menu
- Actions: Buttons letting you edit or delete the visualization configuration
Adding a New Custom Visualization Manifest
To configure a new visualization manifest, click the Add Visualization button in the upper left corner of the page.
Looker displays the New Visualization page:
In the Label field, enter the name of the visualization that will be displayed in the Looker visualization menu. For example, this is how Looker displays a custom visualization labeled “Sankey”:
If the site hosting your custom visualization code uses a subresource integrity (SRI) hash for verification purposes, enter the SRI hash in the SRI Hash field. This field can be found under Advanced options.
Once the visualization has been added, you will see it in the visualization menu in an Explore, and you can use the new visualization type just like any of Looker’s existing visualization types.
Editing a Custom Visualization Manifest
To edit an existing visualization manifest, click the Edit button to the right of the visualization. Looker displays the same page that you use to add a visualization manifest (described above), but with the relevant information already filled in. Make any desired changes, then click Save.
Deleting a Custom Visualization Manifest
To delete a visualization manifest, click the Delete button to the right of the visualization and then click OK in the confirmation box. This removes the visualization from Looker, but will not affect anything in the visualization’s external code repository.
Deleting a visualization manifest disables any Looks or dashboards that use that visualization type. You can correct that by adding back the deleted visualization manifest with the same visualization ID.
Migrating Custom Visualizations
Any custom visualizations stored in the
~/looker/plugins/visualizations directory on your Looker instance must be migrated to the new custom visualization format.
You will see a Migrate Existing Visualizations button in the top left corner of the Edit Visualization page if all of the following are true:
- Your Looker license has been updated to support custom visualizations.
You have existing custom visualizations in the
~/looker/plugins/visualizationsdirectory on your instance.
Click the Migrate Existing Visualizations button to have Looker update your existing configurations to the format required for Looker 5.14.
After you have finished migrating your configurations and adding any additional dependencies, your prior visualization types will appear in the visualization list.