Skip to main content
Controls allow you to choose which fields will be shown in a tile.

ā€‹
Creating dashboard controls

To add a control to the dashboard, go into edit mode and select Add Control. Configuring a control asks that you start by picking one of the underlying fields common to the tiles you want to control. Otherwise the control will have no impact (e.g. adding a field switcher between ā€œorder volumeā€ and ā€œtotal salesā€ to a tile that is showing ā€œuser countā€ will have no impact). Like filters, when you are editing the control you can pick which tiles on the dashboard to connect by toggling the icon in the top right of each tile. You can also set initial default values and optionally hide the control from dashboard viewing.

ā€‹
Control types

There are five types of controls:
These controls will allow the dashboard viewer to swap a single field for another field within the underlying query. When used with dimensions, this will change the grouping or breakdown of a query. For example, a field switcher with dimensions like country, gender, and age group to allow viewers to slice the metrics in the connected tiles in different ways. When used with measures, the metric to displayed in the connected charts will update.When configuring, you can add as many fields to the field swapper as you need. While typically a field swapper is all measures or all dimensions, they can be mixed. You can also select to add a ā€œno fieldā€ option. This is useful for situations where you may want to offer viewers a way to see the total metric value or pick a dimension to change the grouping.
A multi-field picker allows you to pick zero or more fields to show in a chart. Usually most useful on table visualizations, it can be connected to any chart tile on the dashboard.
For date fields, you may want to provide a control to allow the viewer to change the granularity of the date grouping. For example, change a grouping from months to weeks or to days. Time frame switchers make this easy. When configuring, select the underlying date field to control and then select the time frames you want to make available.
To compare a metric between time periods, use a period over period control. When configuring, select the underlying date field that controls the time periods you want to compare. Choose the current period and one or more comparison periods. Any attached charts will break down the metric between the current and previous time period(s).
A parent controls coordinates the toggling of multiple controls at once. A common example here is for a dashboard that has a timeseries with a created_at date, another timeseries with a recieved_at date, and lastly a timeseries with a returned_at date. This canā€™t be done with a single time frame switcher. Instead, build 3 time frame switchers and then add a parent control to control all 3 time frame switchers. You can then hide each child time frame switcher.To configure the control, youā€™ll need to add the display options for the parent control and then connect the children options to the parent options.mobile-display