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


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.