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

# suggestion_list

> Explicitly sets the list of filter options, bypassing the default behavior.

By default, filters run a `SELECT DISTINCT(${field})` to populate filter suggestions. Using this parameter will bypass the default behavior and explicitly set the list of filter options.

## Syntax

```yaml theme={null}
<measure_name>:
  suggestion_list: [<value1>, <value2>, ...]
```

## Properties

<ParamField path="measure_name" type="object[]">
  The name of the measure.

  <Expandable title="measure_name properties" defaultOpen="true">
    <ParamField path="suggestion_list" type="array">
      An unquoted, comma-delimited list of values to use as filter suggestions.
    </ParamField>
  </Expandable>
</ParamField>

## Examples

```yaml theme={null}
status_list:
  aggregate: list
  sql: ${status}
  suggestion_list: [complete, pending]
```