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

# default_filters - Composite topics

> Applies a filter to all queries that start on the composite topic.

Applies a filter to all queries that start on the composite topic. Filters created using this parameter are visible in workbooks and can be removed by users.

When a new `default_filter` is defined, it will only apply to new queries. The filter will not be added to existing queries.

Refer to the [Filters documentation](/modeling/filters) for filter operator syntax and examples.

## Syntax

```yaml theme={null}
default_filters:
  <field_reference>:
    <filter_operator>: <value>
```

## Properties

<ParamField path="default_filters" type="object" required>
  A map of field references to filter conditions.

  <Expandable title="default_filter properties" defaultOpen="true">
    <ParamField path="field_reference" type="object" required>
      The field to filter on, specified in one of the following formats:

      * **Shared dimension or measure name**: `created_date`
      * **Shared view field**: `view.field` (e.g., `users.state`)
      * **Topic-scoped field**: `topic.view.field` (e.g., `orders_topic.orders.status`)

      <Expandable title="filter operators" defaultOpen="true">
        <ParamField path="filter_operator" type="any" required>
          The filter operator and value to apply. Refer to the [filter syntax documentation](/modeling/filters) for available operators like `is`, `not`, `contains`, `greater_than`, etc.
        </ParamField>
      </Expandable>
    </ParamField>
  </Expandable>
</ParamField>

## Examples

### Default filter on shared dimension

```yaml theme={null}
default_filters:
  created_date:
    time_for_duration: '30 days ago for 30 days'
```

### Default filter on topic-scoped field

```yaml theme={null}
default_filters:
  orders_topic.orders.status:
    is: complete
```

### Default filter on shared view field

```yaml theme={null}
default_filters:
  users.state:
    is: California
```

### Multiple default filters

```yaml theme={null}
default_filters:
  created_date:
    time_for_duration: '30 days ago for 30 days'
  orders_topic.orders.status:
    is: complete
  users.state:
    is: California
```