• Products
  • Documentation
  • Resources

Atlassian Analytics is in an early access program

Only people who are part of this invite-only early access program have access to Atlassian Analytics.

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 a Background color for your control. By default, it uses the color from the dashboard theme.

  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

Min

The minimum value for the control’s range

Max

The maximum value for the control’s range

Precision

Enforces increments when selecting values in the range

Default values

Set default values to select when you open the dashboard


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.

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.

Using a Range input control to filter the Issue Number column in a visual mode query.

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:

1 2 3 SELECT "Jira Issue"."issue_id" AS "Issue Id" FROM "jira _issue" AS "Jira Issue" WHERE "Jira Issue"."time_spent_secs" BETWEEN {RANGE_INPUT_NAME.START} AND {RANGE_INPUT_NAME.END};

Verify your chart is connected to the control

To make sure you’ve properly connected your chart to the control, you could verify this by updating the values of the control and seeing if your connected chart filters accordingly.

Alternatively, there are two ways you can check for all charts that are connected to the control.

One option is to:

  1. Hover over the control.

  2. Select its More actions () menu > Show connected charts.

The other option is to:

  1. Select Settings from the dashboard sidebar.

  2. Go to the Variables tab.

  3. Select the chevron () next to the variable name of the control to expand its settings.

  4. Select Show connected charts.

Both options highlight all charts on the dashboard that are connected to that particular control.

Additional Help