# Select Filters Template

### Overview

Run the **Select Filters Template** action from a handler.

This action loads a saved **Filter Template** into the **Filter Panel**. It does not apply conditions. Users can review the filters 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 → Select Filters Template`.
* **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 Template**\
A saved set of filter conditions.\
Templates can contain placeholders populated at runtime.

**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**\
`Select Filters Template`

**Action parameters**\
JSON object used to select the template and provide substitution values.

{% hint style="info" %}
This action **replaces** the current Filter Panel state. It still does not apply conditions. Chain [Apply Filter Conditions](https://docs.flexikanban.ai/references/handlers/kanban-api-handler-types/filters/apply-filter-conditions) if you want auto-apply.
{% endhint %}

### Parameters

<table data-header-hidden><thead><tr><th width="106.94921875"></th><th width="513.74609375"></th><th></th></tr></thead><tbody><tr><td>Name</td><td>Description</td><td>Required</td></tr><tr><td><code>template</code></td><td>The name of the <strong>Filter Template</strong> to load.</td><td>Yes</td></tr><tr><td><code>values</code></td><td>JSON object containing values used to populate filter items defined in the template.</td><td>No</td></tr></tbody></table>

#### `values` notes

* Keys must match the template’s field names.
* Values can be static values or runtime expressions.

### Example

```json
{
  "template": "My Template A",
  "values": {
    "Opportunity.AccountId": "{Opportunity.AccountId}",
    "Opportunity.StageName": "Prospecting",
    "Opportunity.CloseDate": "{$System.Today}"
  }
}
```

***

### Behavior

When the handler runs the action:

1. Retrieves the filters list from the specified **Filter Template**.
2. Applies provided values to the template filter items.
3. Replaces all existing active filters in the **Filter Panel** with the result.
4. Does not apply conditions automatically — the **Filter Panel** opens with the pre-populated filters, and the user must click **Apply** to activate them.

### Related actions

* [Apply Filters Template](https://docs.flexikanban.ai/references/handlers/kanban-api-handler-types/filters/apply-filters-template) (replace panel filters and auto-apply)
* [Merge Filters Template](https://docs.flexikanban.ai/references/handlers/kanban-api-handler-types/filters/merge-filters-template) (merge into existing panel filters)
* [Apply Filter Conditions](https://docs.flexikanban.ai/references/handlers/kanban-api-handler-types/filters/apply-filter-conditions) (equivalent to clicking **Apply**)

### Troubleshooting

**The Filter Panel opens empty.**\
The `template` value may reference a missing template.\
Names are case-sensitive.

**Template values are not substituted.**\
Keys in `values` must match the template’s field names.\
Use API names like `Opportunity.StageName`.

**Existing filters are removed.**\
This is expected.\
Use [Merge Filters Template](https://docs.flexikanban.ai/references/handlers/kanban-api-handler-types/filters/merge-filters-template) to preserve user filters.

**Dynamic expressions in `values` are not resolving.**\
Expressions like `{Opportunity.AccountId}` resolve only when that context exists.\
Place the element where the referenced fields are available.

**Filters are loaded but the board does not update.**\
This action does not apply conditions.\
Users must click **Apply**.