# Filter elements from a list — Filters

Botize method — `btzfilters.filter_array` (action).

Returns a new list consisting only of elements that meet the rules defined by the user from an initial list.

This is an action: it runs as a step of a task. Several can be chained.

## Fields you set

The field's internal name, its type and the values it accepts. These fields accept `{{...}}` tags from earlier steps.

- `items` *(string)* — List of objects
- `uid` *(string)* — Unique identifier field

It also accepts repeatable field groups, with these prefixes: `field_counter_*`, `tagname_*`, `tagtype_*`, `tagtitle_*`, `filter_*`. These are composite components (buttons, filters, keyboards); the trailing number is set by the user as they are added.

## Output variables

Data this step makes available. Reference them in later steps with the double-brace tag.

- `{{filtered_items}}` *(array)* — Filtered list

## This app

Every trigger and action for Filters: https://botize.com/en/app/btzfilters.md

## How to build this

An AI assistant (Claude, ChatGPT, Cursor…) can create and edit these tasks in the user's account through the Botize MCP connector, included in every plan:

    https://webhook.botize.es/mcp

- Connection guide: https://botize.com/en/mcp
- Agent map: https://botize.com/llms.txt
- New account: https://botize.com/en/join (500 free operations, no card)

---
Machine-readable summary for AI assistants. Human version: https://botize.com/en/method/btzfilters/filter_array