# Apply Filter Conditions

### Overview

Run the **Apply Filter Conditions** action from a handler.

This action is the same as clicking **Apply** in the **Filter Panel**. Use it after actions that change filters without auto-apply.

### Handlers and actions

* **Handler**: defines what happens when a user clicks a Kanban UI element.
* **Action**: an executable operation triggered by the handler.
* **Primary action here**: `Kanban API → Apply Filter Conditions`.
* **Optional follow-ups**: configure extra actions on success or failure.

See [Configuring Handlers](https://docs.flexikanban.ai/standard-kanban/tools/configuring-handlers).

### Key concepts

**Filter Panel**\
The panel where active filter conditions are displayed and managed.\
Clicking **Apply** refreshes the board.

**Composite Kanban**\
A parent Kanban with multiple child Kanbans.\
Use `kanbans` to target specific children.

### Configuration

Configure the handler on the interactive element.

**Primary action type**\
`Kanban API`

**Primary action**\
`Apply Filter Conditions`

**Action parameters**\
Optional.\
Use them only for composite Kanban setups.

### Parameters

<table data-header-hidden><thead><tr><th width="119.1171875"></th><th width="495.5703125"></th><th></th></tr></thead><tbody><tr><td>Name</td><td>Description</td><td>Required</td></tr><tr><td><code>kanbans</code></td><td>The IDs of the Kanbans to apply conditions to. Accepts a JSON array (e.g., <code>["kanban_001", "kanban_002"]</code>) or a semicolon-separated string (e.g., <code>"kanban_001;kanban_002"</code>). Only needed for composite Kanbans.</td><td>No</td></tr></tbody></table>

#### `kanbans` notes

* Use this only in a composite Kanban.
* Use an array or a semicolon-separated string.

### Example

```json
{
  "kanbans": ["kanban_001", "kanban_002"]
}
```

### Behavior

When the handler runs the action:

1. Programmatically triggers the Apply action on the **Filter Panel**, activating the current filter state and refreshing the board.
2. If `kanbans` is provided, applies conditions only to the specified Kanbans within a **composite Kanban** setup.

### Related actions

* [Select Filters Template](https://docs.flexikanban.ai/references/handlers/kanban-api-handler-types/filters/select-filters-template) (loads template into the panel)
* [Merge Filters Template](https://docs.flexikanban.ai/references/handlers/kanban-api-handler-types/filters/merge-filters-template) (merges template into the panel)
* [Clear Filter Conditions](https://docs.flexikanban.ai/references/handlers/kanban-api-handler-types/filters/clear-filter-conditions) (clears the panel)
* [Reset Filter Conditions](https://docs.flexikanban.ai/references/handlers/kanban-api-handler-types/filters/reset-filter-conditions) (restores view defaults)

### Troubleshooting

**The board does not refresh.**\
Confirm the handler is firing.\
Confirm the chain order is correct.

**Conditions apply to all Kanbans.**\
Provide `kanbans` to target specific child Kanbans.

**`kanbans` targets the wrong Kanbans.**\
Check the IDs.\
Avoid spaces in the semicolon string.

**Filters look correct, but results are wrong.**\
The action applies whatever is in the panel.\
Review all active filters and orders.