Set up a “Range input” control

“Range input” controls let you filter your data based on a selected numeric range.

Setting up a “Range input” control requires two main steps:

1. Create the “Range input” control for your dashboard.

2. Connect the “Range input” control to a chart.

Create a “Range input” control

To add a “Range input” control to your dashboard:

1. Open the dashboard where you want to add the “Range input” control.

2. Select Add control > Range input from the dashboard sidebar. A pop-up will appear for you to configure the control’s settings.

3. Edit the control’s settings as needed. Go to the next section to learn more about “Range input” settings.

4. Optionally, select Connect this control to new and existing charts. Learn more about connecting the control to charts.

5. Select Add.

6. Place the newly created “Range input” control anywhere on your dashboard.

“Range input” control settings

You can edit the following settings for your “Range input”:

Name

The name of the control

Minimum value

The minimum value for the control’s range

Maximum value

The maximum value for the control’s range

Default start and end values

Set default values to select when you open the dashboard

Precision

Enforces increments when selecting values in the range

Connect a “Range input” control to a chart

After you’re created your “Range input” control, you’ll need to connect it to a chart in order to start using it to filter. Connect it to a chart by using its corresponding dashboard variable in a query.

Automatically connect to new and existing charts

For a “Range input” to automatically connect to a chart, the queries within the chart must:

• be built using visual mode

• use the same data source as the control

If the chart's queries meet these criteria, we’ll automatically apply a query filter to the visual mode queries.

To automatically connect the control to all charts:

1. Create the “Range input” control or edit an existing one by hovering over it and selecting More actions () > Edit control.

2. Select Connect to new and existing charts.

3. Select a Data source and Column. The “Range input” control will filter the selected column.

4. Select a Filter operator to use in the automatically applied query filter. Learn more about the available filter operators.

5. Select Add or Save to apply the changes to the control.

Manually connect to charts

In a visual mode query

To connect a “Range input” control to a chart using a visual mode query:

1. Open the chart editor by creating a new chart or editing an existing chart on the dashboard.

2. In the “Filters” section of your visual mode query:

   1. Add the numeric column you want the control to filter.

   2. Select between and including as the filter operator.

   3. Reference your control using its dashboard variable:

      • Use {RANGE_INPUT_NAME.START} for the selected start point of the range.

      • Use {RANGE_INPUT_NAME.END} for the selected end point of the range.

      • Replace RANGE_INPUT_NAME with the name of your control.

3. Select Run query. The result table will update with the new filter applied to the data.

4. Select Save to dashboard to save the chart.

In a SQL mode query

Connect a “Range input” control in your SQL mode query by referencing the control using its dashboard variable:

• Use {RANGE_INPUT_NAME.START} for the selected start point of the range.

• Use {RANGE_INPUT_NAME.END} for the selected end point of the range.

Replace RANGE_INPUT_NAME with the name of your control.

Here’s an example of how you might get a list of Jira issue IDs where the total amount of logged work is between the selected values of a “Range input” control: