Build dashboards
The dashboard is the screen the team will open every day. It brings together the main indicators, the trend over time, rankings and detail, with filters so each person sees their own site, region or area. A well-built dashboard tells a story from top to bottom: first the result, then the trend, finally the cases that require action. With chained controls and a saved default time range, whoever opens the dashboard finds the right view right away, without configuring anything.
Create a dashboard
- Open ☰ → Analytics → Dashboards.
- Click Create dashboard.
- The dashboard opens empty, in edit mode. Add the first chart with the Add button.
- Click Save, give it a title and save. See Save the dashboard.
To open an existing dashboard, search for its name in the Dashboards list.
Edit mode and view mode
- View mode — the dashboard is used: filters, time range, clicks on charts. Nothing changes in the saved dashboard.
- Edit mode — the dashboard is built: add, move, resize and configure charts. To enter, click Edit. To leave, save or click Switch to view mode.
Changes made in edit mode only take effect after Save.
Add content
With the dashboard in edit mode, click Add:
| Option | What it adds |
|---|---|
| Visualization | A new chart, created in the editor. See Create charts. |
| Controls | List filters at the top of the dashboard. See Controls. |
| Collapsible section | A titled section that can be collapsed. See Collapsible sections. |
| Markdown text | A formatted text block, to explain the dashboard or an indicator. See Text and links. |
| Links | Shortcuts to other dashboards or external pages. |
| Image | An image, such as the company logo or a plant layout. |
| Maps | A map, when the data source has a location. See Maps. |
| Add from library | An existing chart or saved search from the library. |
Organize the dashboard
- Move — drag the chart by its title (or top area).
- Resize — drag the bottom right corner.
- Duplicate — in the chart's ⋯ menu, use Duplicate to create a similar chart from an existing one.
Recommended hierarchy
| Position | Content | Chart types |
|---|---|---|
| Top | Dashboard filters and a short text, if the audience is not technical | Controls, text |
| First row | The main indicators, side by side | Cards, gauges |
| Middle | Trend over time and comparisons | Lines, bars |
| Lower | Rankings and cross-analyses | Horizontal bars, heat maps, colored tables |
| Bottom | Detail and cases for action | Tables, saved search |
Dashboards with many charts become slow and hard to read. Above 10 or 12 charts, use collapsible sections or split into more than one dashboard, connected by a links panel.
Chart menu
Hover over the chart and click ⋯:
| Option | What it does |
|---|---|
| Edit visualization | Opens the chart in the editor (also via the pencil icon). |
| Settings | Title, description, hide title and the chart's own time range. See Per-chart time range. |
| Duplicate | Creates a copy in the same dashboard. |
| Copy to dashboard | Copies the chart to another dashboard. |
| Maximize | Shows the chart full screen within the dashboard. |
| Inspect | Shows the chart's data table and lets you download it as CSV. See Export a chart's data. |
| Explore in Discover | Opens Discover with the chart's data source, filters and time range. |
| Save to library / Unlink from library | Links the chart to the library (to use it in several dashboards) or unlinks it, making it independent. |
| Remove | Removes the chart from the dashboard. |
Editing options appear in edit mode. In view mode, the menu shows viewing options such as Maximize and Inspect.
Per-chart time range
A chart can use a time range different from the dashboard. For example: the dashboard shows the last 12 months, but the top cards always show year to date.
- In edit mode, click ⋯ → Settings on the chart.
- Enable Apply custom time range.
- Choose the range, the same way as in the time picker.
- Click Apply and save the dashboard.
The range appears as a badge in the chart's corner. That chart no longer follows the dashboard range, but still obeys filters and controls.
Readers tend to assume every chart uses the same time range. Include the range in the title of charts with their own range, for example "5S Total (%) – year to date".
Controls
Controls are selection lists at the top of the dashboard. With them, each person filters the whole dashboard by their own site, region or area, without typing expressions.
Add a control
- In edit mode, click Add → Controls (or Add control, in the controls bar).
- Fill in:
| Field | What to enter |
|---|---|
| Data view | The field's data source. |
| Field | The field (for example, site). For text, use the .keyword version if it appears. |
| Control type | Options list for text, Range slider for numbers. |
| Label | The control name, such as "Site". |
| Minimum width | Control width: small, medium or large. |
| Allow multiple selections | Allows choosing more than one option at a time. |
- Click Save and close.
- Repeat for the other controls.
Chained controls
Controls are chained: when a Region is chosen, the Site list only shows that region's sites. That's why controls should be created from general to specific, for example:
- Division
- Region
- Site
- Area
To reorder, drag the controls in the bar. In the controls bar settings (gear), check that Chain controls and Validate user selections are enabled.
Controls bar options
In the controls bar gear:
- Label position — label above or beside the control.
- Chain controls — chains controls in the order they appear.
- Validate user selections — ignores selections that have no collections with the other filters.
- Apply selections automatically — applies the selection immediately. When off, a button appears to apply all selections at once, useful in heavy dashboards.
- Delete all — removes every control.
A control's selection applies to every chart in the dashboard that has a field with the same name, even from another data source. Charts from a data source without that field may become empty when an option is selected. Standardize field names in the forms and test each control by watching every chart.
A card fixed to year to date still changes when the reader chooses a site. Only the time range is fixed.
Collapsible sections
Sections organize large dashboards into titled blocks that can be opened and closed.
- In edit mode, click Add → Collapsible section.
- Click the section title to rename it (for example, "Detail by site").
- Drag charts into the section.
Collapsed sections don't load their charts until opened, which makes the dashboard faster. Use them for detail blocks that not every reader needs to see.
Text and links
Text block
Use a text block to explain the dashboard's purpose, the target and how to read the colors. Text supports simple formatting: headings (#), bold (**text**), lists (-) and links.
Example:
**How to read this dashboard**
- The compliance target is **70%**.
- Colors: red below 60%, yellow between 60% and 70%, green from 70%.
- Cards show year to date; charts show the last 12 months.
Links panel
- In edit mode, click Add → Links.
- Choose the orientation: Horizontal or Vertical.
- Click Add link and choose the type:
- Dashboard — another dashboard. The option to keep filters and time range carries the current view to the target dashboard.
- URL — an external page, such as a procedure or the form itself.
- Give each link a text and save.
Links let you build navigation between dashboards: a general dashboard with links to each area's dashboards.
Dashboard settings
In edit mode, click Settings at the top of the dashboard:
| Option | What it does |
|---|---|
| Title and Description | Dashboard name and description, shown in the dashboard list. |
| Tags | Labels to organize and find dashboards. |
| Store time with dashboard | Saves the current time range as the dashboard's default. |
| Use margins between panels | Space between charts. |
| Show panel titles | Shows or hides every chart title. |
| Sync color palettes across panels | Uses the same colors for the same values in every chart. |
| Sync cursor across panels | Hovering over a date in one chart marks the same date in the others. |
| Sync tooltips across panels | Shows the tooltips of every chart at once. |
Save the dashboard
- Click Save.
- The first time, give it a title. Suggested pattern: Area – Objective – Audience, for example "Quality – Nonconformities – Management".
- Select Store time with dashboard so the current time range becomes the default when the dashboard opens.
- Click Save.
To create a copy, use Save as and select the option to save as a new dashboard.
The search bar, pills and control selections active when saving are stored in the dashboard. Before saving, clear selections used only for testing.
Use the dashboard
- Filter by clicking — click a bar, slice or cell to filter the dashboard by that value.
- Select a time range on the chart — in charts with dates, click and drag over the chart.
- Refresh — the Refresh button fetches the latest collections. With Refresh every, in the time picker, the dashboard updates itself.
- Full screen — the Full screen button hides menus and bars, for display on a TV or projector.
- See a chart enlarged — ⋯ → Maximize.