Add Quiver dashboard to a Marketplace product [Beta]

Use Foundry DevOps to include your Quiver dashboard in Marketplace products for other users to install and reuse. Learn how to create a Marketplace product.

Supported features

Quiver dashboards with the following features are supported:

  • Object analytics cards, such as filter object set, set math, and linked object sets.
  • Object-based visualizations (charts) such as bar chart, line chart, and heat grid. Vega plots can also be packaged as long as the underlying transform table is supported.
  • Time series charts and plots, including events and grouped plots.
  • Tables including most pivot tables, and transform tables with transforms such as group by, join, and filter.
  • Basic visualizations including numeric cards, string cards, text cards, and date/time cards are supported.

How to package dashboards

  1. From the right side of the dashboard settings pane, select the Enable Marketplace templating option.
  2. Select the Run validation button in the header to identify potential Marketplace templatization issues, if any.
  3. If the validator does not display any errors, the dashboard Publish or Republish button will also save a Marketplace-ready version of the dashboard.
  4. Use that dashboard version in a new or existing Marketplace product.
Linter configuration.

The linter may indicate up to three main classes of errors:

  • Unsupported cards: The card is not currently supported for Marketplace templatization.
  • Unsupported configuration: The card is supported, but its configuration is not supported (such as seen in the pivot table examples below). Review the error message provided to learn more.
  • Unexpected errors: In most cases, resolving the above two items will remove any unexpected errors. If unexpected errors remain, contact Palantir Support.
Linter errors on display as an example.

The Dashboards section of the Analysis History dialog displays which dashboard versions have been validated for packaging:

Analysis history.

Create an analysis from an installed dashboard

While the underlying Quiver analysis is not packaged alongside the dashboard, you can create a new Quiver analysis from the installed dashboard by selecting Create analysis from dashboard.

Create analysis from dashboard.

The created analysis will contain a copy of this dashboard, all cards visible in the dashboard, and their upstream dependencies.

The created analysis and its dashboards will be disconnected from the installed dashboard. Modifications to the analysis will not update the installed dashboard, and changes made to the installed dashboard will not be automatically incorporated into the analysis.

Feature usage considerations

The feature's capabilities are still being actively developed. While in beta, take note of the following important usage considerations.

Unsupported cards

Currently, the main classes of unsupported cards are:

  • Materializations: Most cards that use Materialization data types
  • Data-based configurations: Certain cards which derive their configuration from underlying data (see the pivot table section below as an example)

Time series

Most Foundry time series features are supported in Marketplace products. However, time series measures are not currently supported in Marketplace.

To ensure compatibility with Marketplace, your dashboard must:

  • Not use measures capabilities in time series features and transforms.
  • Not have measure columns added to the transform table or object set views. These can be removed from the transform table display settings.

If the linter detects any measures are used, the linter will throw an unsupported configuration error, detailing the offending card and/or measure(s).

As an alternative to using measures capabilities, you can directly import a series from its sensor object, which is a supported method.

Pivot tables

The pivot table card is available but has limitations when a transform table is downstream, affecting column renaming and row operations. Ensure your card:

  • Contains no column properties, as the columns would have been based on underlying data.
  • Have labels configured the input pivot table card for any aggregations to ensure a stable and unique column name.

Additionally, if there is a Selected Object Set card downstream from a pivot table, its selected data will be cleared before packaging.