---
title: "Filter: bricks/query_filters/filter_query_vars"
description: "Filters the query variables generated by an active filter element before they are applied to the query loop. This allows you to customize how specific filters."
canonical: "https://academy.bricksbuilder.io/developer/hooks/filters/bricks-query_filters-filter_query_vars/"
markdownUrl: "https://academy.bricksbuilder.io/developer/hooks/filters/bricks-query_filters-filter_query_vars.md"
pageType: "article"
section: "developer"
category: "hooks"
lastmod: "2026-05-21T13:58:32.000Z"
---
Filters the query variables generated by an active filter element before they are applied to the query loop. This allows you to customize how specific filters affect the query.

## Parameters

- `$query_vars` (*array*): The `WP_Query` arguments generated by this filter.
- `$filter` (*array*): The active filter data (settings, selected values).
- `$query_id` (*string*): The ID of the query loop being filtered.
- `$filter_index` (*int*): The index of this filter in the active filters list.

## Example usage

```php
add_filter( 'bricks/query_filters/filter_query_vars', function( $query_vars, $filter, $query_id, $filter_index ) {
    // Example: Add extra query args for a specific filter
    if ( $filter['settings']['fieldName'] === 'my_special_filter' ) {
        $query_vars['post_status'] = 'publish';
    }

    return $query_vars;
}, 10, 4 );
```