# Add Filter Condition

### Overview

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

This action appends a new condition to 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 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 Filter Condition`

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

{% hint style="info" %}
This action always adds a new condition. It can create duplicates for the same field.
{% endhint %}

### Parameters

<table data-header-hidden><thead><tr><th width="109.48828125"></th><th width="513.2265625"></th><th></th></tr></thead><tbody><tr><td>Name</td><td>Description</td><td>Required</td></tr><tr><td><code>object</code></td><td>The Salesforce object name the condition applies to (e.g., <code>Opportunity</code>).</td><td>Yes</td></tr><tr><td><code>field</code></td><td>The field name on the object to filter by (e.g., <code>StageName</code>).</td><td>Yes</td></tr><tr><td><code>operator</code></td><td>The comparison operator for the condition (e.g., <code>equals</code>, <code>greater than</code>, <code>less than</code>).</td><td>Yes</td></tr><tr><td><code>value</code></td><td>The value to compare against.</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
{
  "object": "Opportunity",
  "field": "StageName",
  "operator": "equals",
  "value": "Prospecting",
  "columns": ["col_001", "col_002"]
}
```

### Behavior

When the handler runs the action:

1. Adds a new filter condition to the **Filter Panel** using the specified object, field, operator, and value.
2. If `columns` is provided, scopes the condition to the specified Kanban columns only.
3. Does not replace existing filters — if a condition for the same field already exists, a duplicate condition is added alongside it.
4. Does not apply conditions automatically — the user must click **Apply** in the Filter Panel to activate the updated filters.

***

### Related actions

* [Add Labels Filter Condition](https://docs.flexikanban.ai/references/handlers/kanban-api-handler-types/filters/add-labels-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 condition does not appear in the panel.**\
Check `object`, `field`, `operator`, and `value`.

**A duplicate condition was added.**\
This action always appends.\
It does not merge or replace.

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

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

**The operator is not recognized.**\
Use an operator supported by that field type.\
Text fields cannot use numeric operators.