New in Looker 21.6, all custom visualizations use sandboxed iframes. Looker no longer supports custom visualizations that use unsandboxed iframes.
- Add a
visualizationparameter to your LookML project’s manifest file to add custom visualizations directly to your LookML project. See the
visualizationparameter documentation page for more information.
- Install a visualization from the Looker Marketplace. With the Looker Marketplace Labs feature enabled, you can install Looker Marketplace Plug-Ins, including visualization types that you can add to Looker’s native visualization library. See the Using the Looker Marketplace documentation page for more information about installing Plug-Ins from the Looker Marketplace. See the Developing a custom visualization for the Looker Marketplace documentation page for information about creating a visualization that can be added to the Looker Marketplace and accessed by other Looker users.
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.
Supported visualizations are available for download through the Looker Marketplace.
Viewing a List of Custom Visualizations
To ensure full functionality of downloaded visualizations, admins for customer-hosted deployments should make sure to install the appropriate version of the Chromium renderer.
The Visualizations page in the Platform section of Looker’s Admin menu lists all of the custom visualizations that have been added to your Looker instance through any of the methods described above:
The list includes the following columns:
idparameter when you add a visualization using the LookML project manifest file.
- Label: The name given to the visualization type in the Looker visualization menu. This value is assigned when you add or edit a visualization using the Admin page, or in the visualization’s
labelparameter when you add a visualization using the LookML project manifest file.
urlparameter when you add a visualization using the LookML project manifest file.
- Actions: Buttons to edit or delete the visualization configuration. These buttons are not shown for visualizations added using the LookML project’s manifest file. To edit these visualizations, go to the LookML project’s manifest file and edit the
Adding a New Custom Visualization
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 this Looker GitHub page. You can find instructions for using Looker’s Visualization API to create your own visualization types on this Looker Github page.
Once you know which visualization you’d like to add to your instance, you can use the Visualizations page to add a custom visualization by clicking 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”:
- Click the
...three-dot icon from the visualization menu bar to access the custom visualization.
- Once the visualization is selected, the name of the visualization appears on the visualization menu bar.
- Click the
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. Looker’s custom visualization hosts do not use an SRI hash.
Once the visualization has been added, you will see it as you’ve labeled 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
To edit an existing visualization, click the Edit button to the right of the visualization. Looker displays the same page that you use to add a visualization (described above), but with the relevant information already filled in. Make any desired changes, then click Save.
Deleting a Custom Visualization
To delete a visualization, 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 disables any Looks or dashboards that use that visualization type. You can correct that by adding back the deleted visualization with the same visualization ID.