> ## 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 dimensions

> List the dimensions available for grouping and filtering queries. Bundled with the CLI — no network call.

List the dimensions available for grouping and filtering queries. Bundled with the CLI as static data — no network call.

## Usage

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

## Flags

| Flag                | Description                                                                                         |
| ------------------- | --------------------------------------------------------------------------------------------------- |
| `--search <term>`   | Filter by keyword (matches the dimension key).                                                      |
| `--category <name>` | Filter by category (e.g. `device`, `page`, `geo`, `traffic`, `ads`, `ecommerce`, `emq`, `session`). |
| `--categories`      | Print category names + counts only.                                                                 |

## Examples

```bash theme={null}
upstack dimensions --search utm
upstack dimensions --category traffic
upstack dimensions --categories
```

See [Measures & Dimensions](/data-dictionary/measures-and-dimensions) for full descriptions and example values.