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

# suggest_from_field

> Specifies an alternative field to use for filter suggestions.

By default, filters run a `SELECT DISTINCT(${field})` to populate filter suggestions. In scenarios where that query may be less performant, or in places where developers may want to curate the suggestion list, this parameter can be used to suggest via an alternative field's distinct values.

## Limitations

This parameter can't be used with [`faceting`](/modeling/dimensions/parameters/faceting) on the same dimension.

## Syntax

```yaml theme={null}
<dimension_name>:
  suggest_from_field: <view_name>.<field_name>
```

## 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="suggest_from_field" type="string">
      The field to use for filter suggestions, specified as `view_name.field_name`.
    </ParamField>
  </Expandable>
</ParamField>

## Examples

```yaml title="Filter-only field with suggestions" theme={null}
filters:
  status:
    type: string
    suggest_from_field: order_items.status
```

```yaml title="Dimension with alternative suggestions" theme={null}
status_from_an_obscure_subquery:
  sql: status_from_an_obscure_subquery
  suggest_from_field: order_items.status
```