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

# synonyms

> Alternative names and terms for a dimension that help the Omni Agent match user queries to the correct field.

When users ask questions using different terminology, synonyms help the AI understand which field they mean.

Refer to the [Optimizing models for AI](/modeling/develop/ai-optimization) guide for more information on best practices.

## Syntax

```yaml theme={null}
<dimension_name>:
  synonyms: [<synonym_1>, <synonym_2>, ...]
```

## 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="synonyms" type="string[]">
      A list of alternative names and terms that refer to this dimension. Include common variations, abbreviations, and domain-specific terminology.
    </ParamField>
  </Expandable>
</ParamField>

## Examples

```yaml title="Customer field synonyms" theme={null}
customer_name:
  synonyms: [client, account, buyer, purchaser]
```

```yaml title="Revenue field synonyms" theme={null}
total_revenue:
  synonyms: [sales, income, earnings, gross revenue, top line]
```

```yaml title="Date field synonyms" theme={null}
order_date:
  synonyms: [purchase date, transaction date, order timestamp]
```