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

<AgentInstructions>

## Submitting Feedback

If you encounter incorrect, outdated, or confusing documentation on this page, submit feedback:

POST https://docs.omni.co/feedback

```json
{
  "path": "/modeling/query-views/parameters/filters",
  "feedback": "Description of the issue"
}
```

Only submit feedback when you have something specific and actionable to report.

</AgentInstructions>

# filters

> Defines the filters applied in the query.

<Tip>
  Check out the [Filter documentation](/modeling/filters) for syntax information and [examples](/modeling/filters/examples).
</Tip>

## Syntax

```yaml theme={null}
query:
  filters:
    <filter_field>:
      <filter_condition>: <value>
```

## Properties

<ParamField path="query" type="object[]">
  An object containing the individual parameters that make up a query view's query definition.

  <Expandable title="query properties" defaultOpen="true">
    <ParamField path="filters" type="object[]">
      A mapping of field names to their filter conditions using [filter syntax](/modeling/filters).

      <Expandable title="filters properties" defaultOpen="true">
        <ParamField path="filter_field" type="string">
          The field to filter on, specified in the format `view_name.field_name`. Can be a time, numeric, or string field.

          <Expandable title="filter_field properties" defaultOpen="true">
            <ParamField path="filter_condition" type="varies">
              The filter condition, specified using [filter syntax](/modeling/filters).
            </ParamField>
          </Expandable>
        </ParamField>
      </Expandable>
    </ParamField>
  </Expandable>
</ParamField>

## Examples

```yaml title="users created in 2021 & order_items from the past 30 days" highlight={6-12} theme={null}
query:
  fields:
    users.id: id
    order_items.sale_price_sum: sales
  base_view: order_items
  filters:
    users.age_bin:
      is: []
    users.created_at:
      is: "2021"
    order_items.created_at:
      time_for_duration: [ 30 complete days ago, 30 days ]
```