# Clear Filter Conditions

### Overview

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

This action clears the **Filter Panel** state. It removes filters, labels, and sort orders. It does not refresh the board. Chain **Apply Filter Conditions** to apply the cleared state.

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

**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**\
`Clear Filter Conditions`

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

### Parameters

<table data-header-hidden><thead><tr><th width="110.94140625"></th><th width="509.26953125"></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 clear conditions from. 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. Removes all conditions (filters, labels, and sort orders) from the **Filter Panel** state.
2. If `kanbans` is provided, clears conditions only for the specified Kanbans within a **composite Kanban** setup.
3. Does not apply changes automatically — the board is not refreshed until Apply Filter Conditions is called.

{% hint style="warning" %}
This action clears the Filter Panel only. It does not clear hidden conditions. Use [Clear Hidden Conditions](https://docs.flexikanban.ai/references/handlers/kanban-api-handler-types/filters/clear-hidden-conditions) for that.
{% endhint %}

### Related actions

* [Apply Filter Conditions](https://docs.flexikanban.ai/references/handlers/kanban-api-handler-types/filters/apply-filter-conditions)
* [Reset Filter Conditions](https://docs.flexikanban.ai/references/handlers/kanban-api-handler-types/filters/reset-filter-conditions)
* [Clear Hidden Conditions](https://docs.flexikanban.ai/references/handlers/kanban-api-handler-types/filters/clear-hidden-conditions)

### Troubleshooting

**The Filter Panel is not cleared.**\
If using `kanbans`, check the child Kanban IDs.

**The board still shows filtered results.**\
Chain [Apply Filter Conditions](https://docs.flexikanban.ai/references/handlers/kanban-api-handler-types/filters/apply-filter-conditions).

**Conditions are cleared for all Kanbans.**\
Provide `kanbans` to target specific child Kanbans.

**Hidden conditions are still active.**\
This action clears only the Filter Panel.\
Use [Clear Hidden Conditions](https://docs.flexikanban.ai/references/handlers/kanban-api-handler-types/filters/clear-hidden-conditions).