# Add Labels Filter Condition

### Overview

Run the **Add Labels Filter Condition** action from a handler.

This action adds a label value to the labels filter in the **Filter Panel**. It does not apply conditions. Users can review the state and click **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 → Add Labels Filter Condition`.
* **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.

### Configuration

Configure the handler on the interactive element.

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

**Primary action**\
`Add Labels Filter Condition`

**Action parameters**\
JSON object that defines the label and optional column scope.

{% hint style="info" %}
Labels are evaluated with OR logic. Any selected label can match.
{% endhint %}

### Parameters

<table data-header-hidden><thead><tr><th width="105.015625"></th><th width="511.27734375"></th><th></th></tr></thead><tbody><tr><td>Name</td><td>Description</td><td>Required</td></tr><tr><td><code>value</code></td><td>The label text that a Kanban card must have to match the filter.</td><td>Yes</td></tr><tr><td><code>columns</code></td><td>The Kanban column IDs to scope the filter to. Accepts a JSON array (e.g., <code>["col_001", "col_002"]</code>) or a semicolon-separated string (e.g., <code>"col_001;col_002"</code>).</td><td>No</td></tr></tbody></table>

#### `columns` notes

* Omitting `columns` applies to all columns.
* Use an array or a semicolon-separated string.

### Example

```json
{
  "value": "Urgent",
  "columns": ["col_001", "col_002"]
}
```

### Behavior

When the handler runs the action:

1. Adds the specified label to the labels filter list in the **Filter Panel**.
2. The labels filter uses OR logic — the board will show cards that have any of the selected labels assigned.
3. If the specified label is already present in the filter list, it is not added again.
4. Does not apply conditions automatically — the user must click **Apply** in the Filter Panel to activate the updated filter.

### Related actions

* [Add Filter Condition](https://docs.flexikanban.ai/references/handlers/kanban-api-handler-types/filters/add-filter-condition)
* [Apply Filter Conditions](https://docs.flexikanban.ai/references/handlers/kanban-api-handler-types/filters/apply-filter-conditions)
* [Clear Filter Conditions](https://docs.flexikanban.ai/references/handlers/kanban-api-handler-types/filters/clear-filter-conditions)

### Troubleshooting

**The label does not appear in the panel.**\
Check that `value` is present and non-empty.

**Cards with the label are not shown.**\
Labels are case-sensitive.\
Match the label text exactly.

**`columns` does not scope correctly.**\
Check the column IDs.\
Avoid spaces in the semicolon string.

**The label appears to be added repeatedly.**\
This action deduplicates by label name.\
Check the input value each click.

**The board does not change.**\
This action does not apply conditions.\
Users must click **Apply**.