Star us on GitHub
Star
Menu

Dashboard Variables

Dashboard variables let you parameterize filters, bucketing, and grouping across multiple graphs. You can create and edit dashboard variables from the dashboard or graphing editor pages.

Variable creation

Variables support three types of suggestions:

SuggestionBehavior
ValueWhen creating the variable, you select a search key. The variable's input is a multiselect showing the possible values for that key.
KeyThe variable's input is a select with all search keys. This is helpful for using a variable in function, grouping, and bucketing rules.
NoneThe variable's input is free text.

Variables will appear in the graphing editor components wherever they can be used, including in the filter, function, grouping, and bucketing rules. To reference a variable, use a dollar sign followed by the variable's name, for example $user.

Variable usage

Variables can be multivalued, e.g. to filter all sessions by a list of users. When using multivalued variables, the resulting filter is a logical OR of all values. For example, email=$users is interpolated to email=(zane@highlight.io OR jay@highlight.io).