# Working with your data

Dashboards, audiences, and campaigns all work from the same data: the variables, tables, audiences, files, behaviours, and expressions in your system. Whenever you filter a dashboard, build an audience, add a measure to a tile, or personalise a message, you choose that data in the same dialogue: the data picker.

Once you know the data picker, you know how to choose data anywhere in Orbit. Two things change, depending on what you're doing:

- **Its title**, such as **Select Filter**, **Select Measure**, or **Select Variable**
- **Its tabs**, because not everything makes sense everywhere

> [!NOTE]
>
> If something you expect isn't in the picker, check what you're adding. For example, you can't split a dashboard tile by an audience, so the picker for a tile's dimension has no **Audiences** tab. Check [where the data picker opens](<#where-the-data-picker-opens>) for what you can choose in each place.

## What you can choose

The data picker gives you six kinds of data. Some come with your system and some you create yourself.

| Choose | Description | Where it comes from |
| --- | --- | --- |
| [Variables](<https://help.apteco.com/en/orbit/data/variables/index.md>) | Fields in your data, such as Region or Donation Amount | Your system. You can also add [custom variables](<https://help.apteco.com/en/orbit/resources/custom-variables/index.md>) |
| [Tables](<https://help.apteco.com/en/orbit/data/tables/index.md>) | The levels of your data, such as Households, People, or Donations | Your system |
| [Audiences](<https://help.apteco.com/en/orbit/data/audiences-and-files/#audiences>) | Groups of records saved in Orbit | Created by you, or shared with you |
| [Files](<https://help.apteco.com/en/orbit/data/audiences-and-files/#files>) | URN files, FastStats selections, and files of values | Saved in your FastStats system, or uploaded in Orbit |
| [Behaviours](<https://help.apteco.com/en/orbit/data/behaviours/index.md>) | Recency, frequency, or value statistics for each contact | Created by you, on the picker's **Behaviours** tab |
| [Expressions](<#expression>) | A value you calculate for each record, such as a supporter's age | Written by you, on the picker's **Expression** tab, or saved in FastStats |

## Find what you need

Use the **Search** tab to find something that already exists. It has up to four tabs of its own:

- **Variables**: The [variables](<https://help.apteco.com/en/orbit/data/variables/index.md>) in your system, in their folders
- **Tables**: Your system's [tables](<https://help.apteco.com/en/orbit/data/tables/index.md>), in their hierarchy
- **Audiences**: Your [audiences](<https://help.apteco.com/en/orbit/data/audiences-and-files/#audiences>), and those shared with you, each with its record count
- **Files**: [URN files, FastStats selections, and files of values](<https://help.apteco.com/en/orbit/data/audiences-and-files/#files>), in their folders

You can search for an item or browse to it:

- **Search**: Type in the search box. Each tab then shows how many results it found. Each result shows an icon for its [variable type](<https://help.apteco.com/en/orbit/data/variables/#types-of-variables>), its name, a short reference, and the folder it's in, so you can tell apart variables with similar names.
- **Browse**: Expand the folders to find the item.

By default, search matches names only, not the categories within a variable. Once you've typed a search, tick **Include codes in search** to also match the categories within each variable, by their codes or descriptions.

> [!TIP]
>
> Looking for a category rather than a variable, such as one region or one appeal? Tick **Include codes in search**, and the results include the variables that contain it.

Select an item to choose it. In some places, such as predefined filters and data grid columns, you can choose several at once. The picker shows how many you've selected, and **Deselect all** clears them.

When only one kind of item makes sense where you are, the picker shows it straight away, with no tabs.

## Create a behaviour or an expression

As well as finding data that already exists, you can create a behaviour or an expression in the picker, and use it straight away.

### Behaviours

Use the **Behaviours** tab to create a recency, frequency, or value behaviour, such as each supporter's most recent donation. If the tab doesn't appear, the table you're working with may not have a child table of transactions. See [Behaviours](<https://help.apteco.com/en/orbit/data/behaviours/index.md>) for how to create each type.

### Expression

Use the **Expression** tab to write an expression that calculates a value for each record, such as each supporter's age. Enter a **Name**, choose the **Table** it calculates for, then write the **Expression**, using the [FastStats expression language](<https://help.apteco.com/en/faststats/expressions/index.md>). For how to use an expression in each context, see:

- [Expressions in audiences](<https://help.apteco.com/en/orbit/audiences/expressions-in-audiences/index.md>)
- [Expressions as filters](<https://help.apteco.com/en/orbit/dashboards/filtering/expressions-as-filters/index.md>) on dashboards
- [Expression measures](<https://help.apteco.com/en/orbit/dashboards/measures/expression-measures/index.md>) on dashboard tiles
- [Expressions in message personalisation](<https://help.apteco.com/en/orbit/campaigns/journey-builder/personalisation/expressions-in-personalisation/index.md>), where you can also search for expressions saved in FastStats

## After you choose

What happens next depends on where you opened the picker:

- **A filter**: Asks which values to include or exclude. For a variable, that depends on its [type](<https://help.apteco.com/en/orbit/data/variables/#filter-by-a-variable>). For an [audience or a file](<https://help.apteco.com/en/orbit/data/audiences-and-files/#include-or-exclude-records>), you choose whether its records are in or out.
- **A [measure](<https://help.apteco.com/en/orbit/dashboards/measures/index.md>)**: Asks how to summarise it, such as **Sum** or **Mean**
- **A [dimension](<https://help.apteco.com/en/orbit/dashboards/dimensions/index.md>)**: Asks how to split it into categories, such as by year

> [!NOTE]
>
> **Example**
>
> To show total donations on a dashboard, a fundraiser adds a number tile and selects **\+ Add Measure**. In the data picker, they search for "donation", choose the **Donation Amount** variable, then choose the **Sum** function.

## Where the data picker opens

These tables list the main places the data picker opens, and what you can choose there. Where you can choose several items at once, the table says so. Anywhere else the picker opens, it works in the same way.

### Audiences

When you build an audience or add pages to it, the picker opens in these places:

| Where | What you can choose |
| --- | --- |
| **\+ Add Filter** in an audience's includes or excludes | Variables, audiences, files, behaviours, and expressions |
| **Order By** on a [limit](<https://help.apteco.com/en/orbit/audiences/building-an-audience/limits/index.md>) | Variables |
| **Per** on an [N per limit](<https://help.apteco.com/en/orbit/audiences/building-an-audience/limits/#n-per-limit>) | Variables and tables |
| A dimension on a workbook cube or chart | Variables, audiences, and behaviours |
| A measure on a workbook cube or chart | Variables, tables, audiences, files, behaviours, and expressions |

### Dashboards

When you filter a dashboard or edit its tiles, the picker opens in these places:

| Where | What you can choose |
| --- | --- |
| [User](<https://help.apteco.com/en/orbit/dashboards/filtering/user-filters/index.md>), [dashboard](<https://help.apteco.com/en/orbit/dashboards/filtering/dashboard-filters/index.md>), and [analysis](<https://help.apteco.com/en/orbit/dashboards/tiles/tile-types/profiling/analysis-filters/index.md>) filters | Variables, audiences, files, behaviours, and expressions |
| [Predefined filters](<https://help.apteco.com/en/orbit/dashboards/filtering/predefined-filters/index.md>) | Variables (several at once), behaviours, and expressions |
| [Search filters](<https://help.apteco.com/en/orbit/dashboards/filtering/search-filters/index.md>) | Variables (several at once) |
| [Tile filters](<https://help.apteco.com/en/orbit/dashboards/filtering/tile-filters/index.md>) | Variables, audiences, files, behaviours, and expressions |
| A tile's [measure](<https://help.apteco.com/en/orbit/dashboards/measures/index.md>) | Variables, tables, audiences, files, behaviours, and expressions |
| A tile's [dimension](<https://help.apteco.com/en/orbit/dashboards/dimensions/index.md>) | Variables and behaviours |
| **Apply Filters** on a dimension | Variables, audiences, files, and behaviours |
| [Data grid](<https://help.apteco.com/en/orbit/dashboards/tiles/tile-types/adding-data-grids-as-dashboard-tiles/index.md>) columns | Variables (several at once), behaviours, and expressions |
| **Set Data** on a [Venn tile](<https://help.apteco.com/en/orbit/dashboards/tiles/tile-types/venn-diagrams/index.md>) | Variables, audiences, files, and behaviours |
| **Variables** on a [profile tile](<https://help.apteco.com/en/orbit/dashboards/tiles/tile-types/profiling/profile-tiles/index.md>) | Variables (several at once) |

### Inside a behaviour

When you create a [behaviour](<https://help.apteco.com/en/orbit/data/behaviours/index.md>), the picker opens again inside it, for example:

| Where | What you can choose |
| --- | --- |
| **Transaction** on a recency behaviour | Variables |
| A behaviour's **\+ Add Filter** | Variables, audiences, files, behaviours, and expressions |

### Campaigns

When you set up a campaign, its messages, or its channels, the picker opens in these places:

| Where | What you can choose |
| --- | --- |
| A variable content field in [message personalisation](<https://help.apteco.com/en/orbit/campaigns/journey-builder/personalisation/index.md>) | Variables |
| An expression content field in message personalisation | Expressions saved in FastStats, or a new expression |
| A behaviour content field in message personalisation | Behaviours |
| A campaign [goal](<https://help.apteco.com/en/orbit/campaigns/journey-builder/goals/index.md>) | Variables and tables |
| Filtering a message [objective](<https://help.apteco.com/en/orbit/campaigns/journey-builder/objectives/index.md>) by audience | Audiences and files |
| A channel's variables, such as the mobile number for [Apteco SMS](<https://help.apteco.com/en/orbit/campaigns/apteco-sms/index.md>) | Variables |

### Resources and settings

The picker also opens when you create custom variables, and in some application settings:

| Where | What you can choose |
| --- | --- |
| A category in a [combine audiences](<https://help.apteco.com/en/orbit/resources/custom-variables/combine-audiences/index.md>) custom variable | Variables, audiences, files, and behaviours |
| The [channel editor](<https://help.apteco.com/en/orbit/integrations/channel-editor/introduction-to-channel-editor/index.md>) | Variables |
| [Category colours](<https://help.apteco.com/en/orbit/reference/admin/application-settings/category-colours/index.md>) | Variables and their categories |
| [Data grid hyperlinks](<https://help.apteco.com/en/orbit/reference/admin/application-settings/data-grid-hyperlinks/index.md>) | Variables |
