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

# aliases

> Create aliases for renamed dimensions to prevent existing Omni content from breaking when field names change in the data model.

Creates an alias for a dimension, allowing you to ensure Omni content that uses the field doesn't break when the field is renamed.

## Syntax

```yaml theme={null}
<field_name>:
  aliases: [OLD_FIELD_NAME]
```

## Properties

<ParamField path="dimension_name" type="object[]">
  The name of the dimension.

  <Expandable title="dimension_name properties" defaultOpen="true">
    <ParamField path="aliases" type="array">
      An array of old field names that should map to the dimension.
    </ParamField>
  </Expandable>
</ParamField>

## Examples

In this example, the `sale_date` field was renamed to `order_date`. Adding `aliases` to the field allows references to `sale_date` to continue working:

```yaml orders.view theme={null}
order_date:
  aliases: [sale_date]
```