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.

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.

Labels are evaluated with OR logic. Any selected label can match.

Parameters

Name	Description	Required
value	The label text that a Kanban card must have to match the filter.	Yes
columns	The Kanban column IDs to scope the filter to. Accepts a JSON array (e.g., ["col_001", "col_002"]) or a semicolon-separated string (e.g., "col_001;col_002").	No

columns notes

• Omitting columns applies to all columns.

• Use an array or a semicolon-separated string.

Example

{
  "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

• Apply Filter Conditions

• 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.