> ## 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/dimensions/parameters/index",
  "feedback": "Description of the issue"
}
```

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

</AgentInstructions>

# All dimension parameters

> Dimensions are attributes that describe a row of data.

| Parameter                                                                                                            | Description                                                                                              |
| -------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------- |
| [ai\_context](/modeling/dimensions/parameters/ai-context)                                                            | Provides context to Omni Agent for better understanding of field usage.                                  |
| [all\_values](/modeling/dimensions/parameters/all-values)                                                            | Provides the complete list of possible values to Omni Agent for dimensions with a fixed set of values.   |
| [aliases](/modeling/dimensions/parameters/aliases)                                                                   | Maps old field names to updated field names to preserve content.                                         |
| [bin\_boundaries](/modeling/dimensions/parameters/bin-boundaries)                                                    | Specifies bins or tiers for a given numeric field.                                                       |
| [colors](/modeling/dimensions/parameters/colors)                                                                     | Defines colors to map to specific dimension values.                                                      |
| [convert\_tz](/modeling/dimensions/parameters/convert-tz)                                                            | Controls whether a field should be converted to the query/user timezone.                                 |
| [custom\_primary\_key\_sql\_for\_quick\_aggs](/modeling/dimensions/parameters/custom-primary-key-sql-for-quick-aggs) | Defines a custom primary key for aggregate measures where a primary key is applicable.                   |
| [description](/modeling/dimensions/parameters/description)                                                           | Provides metadata about the dimension, made available in the workbook UI.                                |
| [display\_order](/modeling/dimensions/parameters/display-order)                                                      | Overrides the sort order for the field picker within a view.                                             |
| [drill\_fields](/modeling/dimensions/parameters/drill-fields)                                                        | Enables hierarchical drilling inside a row of the result set.                                            |
| [duration](/modeling/dimensions/parameters/duration)                                                                 | Calculates the time difference between two timestamp fields in various intervals.                        |
| [dynamic\_top\_n](/modeling/dimensions/parameters/dynamic-top-n)                                                     | Generates dimensions that automatically filter to the top N or bottom N values based on a measure.       |
| [extends](/modeling/dimensions/parameters/extends)                                                                   | Inherits configuration from a dimension defined in another view.                                         |
| [faceting](/modeling/dimensions/parameters/faceting)                                                                 | Controls filtering of suggestions by other filters when faceting is enabled                              |
| [filter\_single\_select\_only](/modeling/dimensions/parameters/filter-single-select-only)                            | Restricts a dimension to only allow single-value style filters.                                          |
| [format](/modeling/dimensions/parameters/format)                                                                     | Sets default or conditional formatting for number and date dimensions.                                   |
| [group\_label](/modeling/dimensions/parameters/group-label)                                                          | Nests a group of fields in the field picker for curated organization.                                    |
| [groups](/modeling/dimensions/parameters/groups)                                                                     | Buckets results with CASE-like logic by filtering field values into labeled groups.                      |
| [hidden](/modeling/dimensions/parameters/hidden)                                                                     | Removes the field from the UI while keeping it referenceable in the model.                               |
| [ignore\_from\_extended](/modeling/dimensions/parameters/ignore-from-extended)                                       | Controls whether a field should be omitted during explicit extensions of a view.                         |
| [ignored](/modeling/dimensions/parameters/ignored)                                                                   | Removes a field from the UI and prevents references to it.                                               |
| [label](/modeling/dimensions/parameters/label)                                                                       | Overrides the field name for all UI appearances.                                                         |
| [level\_of\_detail](/modeling/dimensions/parameters/level-of-detail)                                                 | Creates a Level of Detail field, which controls the granularity at which an aggregation is computed.     |
| [links](/modeling/dimensions/parameters/links)                                                                       | Adds external links to templated URLs in the drill menu.                                                 |
| [markdown](/modeling/dimensions/parameters/markdown)                                                                 | Mustache template rendered as Markdown in data table columns.                                            |
| [order\_by\_field](/modeling/dimensions/parameters/order-by-field)                                                   | Sets a field to be sorted by another field's values.                                                     |
| [parent\_field](/modeling/dimensions/parameters/parent-field)                                                        | Declares a dimension as a child of another dimension for nested field display.                           |
| [primary\_key](/modeling/dimensions/parameters/primary-key)                                                          | Sets the primary key on a view for preventing fan outs in calculations.                                  |
| [required\_access\_grants](/modeling/dimensions/parameters/required-access-grants)                                   | Defines a list of access grants for the dimension, which are used to control access.                     |
| [sample\_values](/modeling/dimensions/parameters/sample-values)                                                      | Provides sample values to Omni Agent to better understand field content and usage.                       |
| [skip\_parent\_label](/modeling/dimensions/parameters/skip-parent-label)                                             | Controls whether child dimension labels are prepended with the parent field label in grouped dimensions. |
| [sql](/modeling/dimensions/parameters/sql)                                                                           | The core declaration of the field definition using SQL.                                                  |
| [suggest\_from\_field](/modeling/dimensions/parameters/suggest-from-field)                                           | Specifies an alternative field to use for filter suggestions.                                            |
| [suggest\_from\_topic](/modeling/dimensions/parameters/suggest-from-topic)                                           | Explicitly sets the topic to use for filter suggestions.                                                 |
| [suggestion\_list](/modeling/dimensions/parameters/suggestion-list)                                                  | Explicitly sets the list of filter options, bypassing default behavior.                                  |
| [synonyms](/modeling/dimensions/parameters/synonyms)                                                                 | Alternative names that help the Omni Agent match user queries to the correct field.                      |
| [tags](/modeling/dimensions/parameters/tags)                                                                         | Metadata used for field search in workbooks, curating fields, and curating drill fields.                 |
| [timeframes](/modeling/dimensions/parameters/timeframes)                                                             | Sets the default time segments available for date/time fields in workbooks.                              |
| [view\_label](/modeling/dimensions/parameters/view-label)                                                            | Nests a field under a different view than its default parent view.                                       |
