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

# display_order - Composite topics

> Defines the order that composite topics display in the topic picker.

Defines the order that composite topics display in the workbook topic picker. By default, composite topics are sorted alphabetically by label. Defining a `display_order` overrides this default for the composite topic.

## Syntax

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

## Properties

<ParamField path="display_order" type="integer">
  The display order of the composite topic in the topic picker. Must be a whole number. Composite topics with lower numbers appear first.
</ParamField>

## Behavior

Composite topics are listed in their own group of the topic picker. `display_order` sets the position within that group:

* Composite topics with a `display_order` appear first, from lowest number to highest.
* Composite topics without a `display_order` follow, sorted alphabetically by label.

## Examples

```yaml title="orders_marketing.composite_topic" theme={null}
topics: [orders_topic, marketing_topic]
display_order: 1
```