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

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

</AgentInstructions>

# display_order

> Overrides the sort order for the field picker within a view.

By default, dimensions are sorted alphabetically. Defining a `display_order` will override this default.

For fields inside groups using [`group_label`](/modeling/dimensions/parameters/group-label), the group will be ranked with the `min` of all the fields in the group. For example, if there are 3 fields with `display_order` of `4`, `5` and `{empty}`, the group will have a `display_order` of 4).

## Syntax

```yaml theme={null}
<dimension_name>:
  display_order: <number>
```

## Properties

<ParamField path="dimension_name" type="object">
  The name of the dimension. Dimension names must:

  * Be unique within the view
  * Start with a letter
  * Contain only alphanumeric characters and underscores

  <Expandable title="dimension_name properties" defaultOpen="true">
    <ParamField path="display_order" type="integer">
      A whole number that determines the field's position in the field picker. Lower numbers appear first.
    </ParamField>
  </Expandable>
</ParamField>

## Examples

```yaml title="Ordering fields" theme={null}
first_name:
  display_order: 1

last_name:
  display_order: 2
```