Skip to content

Use variables

1 min read · Updated 23 Sept 2026

Variables let a cell in your sheet drive what a dataset returns — type a region in a cell, and the data underneath re-queries for that region. It’s what-if analysis on live, trusted data.

A variable has a name (e.g. Color) and a cell or range it reads from (e.g. Sheet1!B2).

You’re connected to Astrato (see Connect to Astrato).

  1. Open the Astrato panel and go to Variables.

  2. Click +.

  3. Name it.

  4. Enter or pick the cell (or range) it should read.

  5. Click Save.

Creating a variable that reads a cell

The saved variable in the Variables list

Result: the variable shows up in your Variables list with the cell it’s watching.

In the dataset panel, find a setting that accepts a variable and map it to yours. From then on, whatever’s in that cell is sent with the query. Change the cell, and datasets that use it can refresh themselves automatically (unless their refresh mode is Refresh manual).

Mapping a variable to a dataset setting

How refresh mode affects this: see Refresh modes in Create and manage datasets.

Want a different value just once? Override it inline:

=ASTRATO.TABLE("Sales", ASTRATO.VARIABLE("Color", "Blue"))

That uses Blue for this formula only; your saved variable doesn’t change.

If a variable drives a filter, set it to NA() to switch that filter off for one formula:

=ASTRATO.TABLE("Sales", ASTRATO.VARIABLE("Regions", NA()))

A variable can point at a range, not just one cell — perfect for a list, like several selected regions. Blank cells in the range are ignored.