> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.wickedcms.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.wickedcms.com/_mcp/server.

# Filter items

Filters let you show only items that match specific criteria — by status, publish state, dates, or collection field values.

![Filter items](https://files.buildwithfern.com/wicked-cms.docs.buildwithfern.com/6b7fa434f92a8b80aab02d9bf1a12e49ffcae424e4013a1c4f68b67e3d2bbcd0/docs/assets/screenshots/filters.png)

## Show the filter bar

Click the **Toggle filters** button (filter icon) in the collection toolbar to show or hide the inline filter bar.

## Add a filter

Click **Toggle filters** if the filter bar is hidden.

Click the **Filter** button (with + icon) to open the add-filter popover.

Search or browse the list (placeholder: **Filter by...**). Pick a metadata field or a collection schema field.

Choose an operator (such as **Is**, **Contains**, **Is empty**) and enter or select a value.

The filter appears as a chip in the filter bar showing a summary of the condition.

## Built-in metadata filters

You can filter by these standard properties:

* **Name**
* **Status**
* **Publish State**
* **Archive**
* **Draft**
* **Published** (date)
* **Updated** (date)
* **Created** (date)

## Collection field filters

Wicked CMS also builds filters from your collection schema field types, including:

* Text fields — **Contains**, **Starts with**, **Ends with**, **Is empty**, etc.
* Option fields — **Is**, **Is not**, **Is set**, **Is empty**
* Switch fields — **Is**, **Is not** (Yes/No)
* Date fields — date ranges (from/to)
* Reference fields — **Is**, **Is not**, **Is set**, **Is empty**
* Multi-reference fields — **Contains**, **Does not contain**, **Is set**, **Is not set**

## Filter operators

Common operators include:

| Operator                            | Use for                                     |
| ----------------------------------- | ------------------------------------------- |
| **Is** / **Is not**                 | Exact match                                 |
| **Contains** / **Does not contain** | Partial text match                          |
| **Starts with** / **Ends with**     | Prefix or suffix match                      |
| **Is empty** / **Is not empty**     | Blank or non-blank values                   |
| **Is set**                          | Field has a value (presence)                |
| **Is not set**                      | Field has no value (multi-reference fields) |

## Manage active filters

* Click a filter chip to edit its condition
* Remove individual filters from the chip menu
* Click **Clear all** when two or more filters are active to remove every filter at once

## Combine with search

Filters work together with [search](/search-items). Items must match both the search query and all active filters.

## Next step

Adjust which columns appear alongside your filtered results in [Customize visible columns](/customize-columns).