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

<AgentInstructions>

## Submitting Feedback

If you encounter incorrect, outdated, or confusing documentation on this page, submit feedback:

POST https://docs.omni.co/feedback

```json
{
  "path": "/modeling/query-views/parameters/dimensions",
  "feedback": "Description of the issue"
}
```

Only submit feedback when you have something specific and actionable to report.

</AgentInstructions>

# dimensions

> Lists all fields selected in the query, making them into dimensions to allow for aggregation in another query.

<Note>
  This is a top-level parameter in query views - it shouldn't be nested under the `query` parameter.
</Note>

## Syntax

```yaml theme={null}
dimensions:
  <dimension_name>: {}
  <dimension_name>: {}
  <calc_name>: {}
  <measure_name>: {}
```

## Properties

<ParamField path="dimensions" type="object">
  A list of dimension names from the query, with each dimension defined as an empty object `{}`.
</ParamField>

## Examples

```yaml title="Query view with age, created_at_year, and calc_1 dimensions" theme={null}
query:
  fields:
    users.age: age
    users.created_at[year]: created_at_year
    calc_1: calc_1
  base_view: users

dimensions:
  age: {}
  created_at_year: {}
  calc_1: {}
```