Skip to main content

Visualization Widget

A saved Analytics visualization as a dashboard tile. Where every other widget reads live fields from a device, this one shows a chart built in Analytics (Beta): a 90-day trend, a ranking of sites, a heatmap by hour of day. It brings the historical view onto the same screen as the live one.

What it shows

Exactly what the visualization shows in the Analytics editor, drawn by the same renderer, at the visualization's saved period. A caption under the chart can print that period (for example "Last 90 days"). Viewers can drill into the chart in place when its author allows it; the tile itself is position and resize only.

A download icon in the tile's header hands viewers the rows behind the chart as CSV, at the level they have drilled to. It is offered when the visualization's author left Data export on in Analytics; there is no per-tile setting. See Downloading the data.

Requirements

  • The account's tier includes Pulse Analytics, at both the partner and the sub-account level. On a tier without it the widget is not offered.
  • A saved visualization exists in the same account as the dashboard. See the scope rule below.

Adding one

In edit mode click + Add visualization, next to + Add widget, and pick from the list. The list only offers visualizations the dashboard may embed. The tile drops into the next open slot; open its settings to adjust it.

Configuring a Visualization widget

FieldWhat it does
TitleHeader text. Defaults to the visualization's name.
VisualizationWhich saved visualization the tile shows. Only the account's own visualizations are listed.
RefreshHow often the tile re-runs the visualization: every minute, every 5 minutes (default), every 15 minutes, or every hour.
Show the period under the chartPrints the saved period beneath the chart.

Scope: which visualizations a dashboard may embed

Embedding never crosses accounts. The list in the add dialog and in the settings drawer is filtered by the dashboard, not by who is editing.

DashboardLists
Fleet and partner dashboardsPartner-level visualizations only.
Sub-account dashboardsThat sub-account's own visualizations only, even when a Partner Administrator is editing.
Device and profile dashboardsThe widget is not available.

The server enforces the same rule when the tile is saved, so a tile can never show one customer's chart on another customer's dashboard.

Time range and refresh

The tile ignores the dashboard's time-range picker. It shows the visualization at its saved period and refreshes on the schedule you set, so a 90-day trend stays a 90-day trend wherever it is placed. Many viewers with the same dashboard open share one cached result for a minute, so a busy dashboard does not run the same query once per viewer.

Visualization tiles are left out of a dashboard shared by public link. Viewers of the link see the rest of the dashboard as usual.

When the visualization changes or is deleted

  • Editing the visualization in Analytics updates every tile that shows it on its next refresh.
  • Deleting it makes those tiles read "Visualization removed". The delete confirmation in the library says how many tiles are affected. Point the tile at another visualization in its settings, or remove it.

Frequently asked

Why is the list in the add dialog empty?

Either the account has no saved visualizations yet, or you are on a dashboard that cannot embed the ones that exist: a partner dashboard lists partner-level visualizations only, and a sub-account dashboard lists that account's only.

Can the tile follow the dashboard's time range?

Not in this release. Change the period on the visualization itself in Analytics.

When to use a different widget