> ## Documentation Index
> Fetch the complete documentation index at: https://docs.upstackdata.com/llms.txt
> Use this file to discover all available pages before exploring further.

# upstack measures

> List the measures catalog from the command line. Find canonical measure ids before building a query or dashboard.

List the measures available to your pixel. Useful for finding canonical measure ids before constructing a [query](/cli/query) or [building a dashboard](/cli/dashboard-view#build). Wraps `GET /api/measures` — see the [API reference](/api-reference/overview).

## Usage

```bash theme={null}
upstack measures
```

Results are cached locally for 1 hour. Pass `--no-cache` to refetch.

## Flags

| Flag                | Description                                                                     |
| ------------------- | ------------------------------------------------------------------------------- |
| `--search <term>`   | Filter by keyword (matches `key`, `title`, and `shortTitle`).                   |
| `--category <name>` | Filter by category (e.g. `Core`).                                               |
| `--categories`      | Print category names + counts only (no individual measures).                    |
| `--detail`          | Include title, description, formula, category, and value type for each measure. |
| `--no-cache`        | Bypass the local 1-hour cache and refetch.                                      |

## Examples

```bash theme={null}
upstack measures --search "new customer roas"
upstack measures --category Core
upstack measures --categories
upstack measures --detail --search mer
```