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, and change its period from a calendar button on the tile, when its author allows it. See Choosing the period yourself.

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 window under the chart with its grain and time zone, for example "Last 90 days · daily · times in America/New_York", or "days in UTC" when the chart is drawn on UTC days.

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. When the author turned on Viewer filters, each viewer can change the tile's period from its calendar button; the choice is theirs alone and resets on reload. 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.

A visualization tile shows on a dashboard shared by public link when the visualization is scoped to specific devices, a site, a network, or a device profile that resolves to at most 200 devices. A visualization over All devices, or one whose scope resolves to more devices than that, stays hidden on the shared page as "Not available on shared dashboards"; the tile's settings say so. The shared page runs the chart over exactly those devices, re-checked on every refresh and never widened past what the link already covered, and a link viewer may change the period only, and only when the author turned on Let viewers choose the period. Drill-down, viewer filters, and the data and image downloads are not offered on a shared page.

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?

No. The tile keeps its saved period. When the author turned on Viewer filters, viewers can change that tile's period from its calendar button, and pick one of its devices, sites, or networks or set a value range from its filter button. See Choosing the period, devices, or range yourself.

When to use a different widget​