New to Kendo UI for Angular? Start a free 30-day trial

FilterExpandSettings

Updated on Oct 30, 2025

Configures the auto-expansion behavior of nodes when filtering the TreeView.

Name Type Default Description

Name	Type	Default	Description
expandedOnClear?	`"none" \| "initial" \| "all" \| "unchanged"`	`"none"`	Determines which nodes should remain expanded when the filter is cleared. The possible values are: `"none"`—Collapse all nodes. `"all"`—Expand all nodes. `"initial"`—Restore the expanded state from before filtering. `"unchanged"`—Leave the expanded state unchanged.
expandMatches?	`boolean`	`false`	Determines whether matching nodes expand to display their children. Only applicable in `"lenient"` filter mode.
maxAutoExpandResults?	`number`	`-1`	The maximum number of filter results that will be auto-expanded. If the number of results exceeds this value, the expanded state will be reverted according to the `expandedOnClear` setting. The default value of -1 allows any number of results to be auto-expanded.

expandedOnClear?


"none" | "initial" | "all" | "unchanged"


"none"

Determines which nodes should remain expanded when the filter is cleared. The possible values are:

"none"—Collapse all nodes.
"all"—Expand all nodes.
"initial"—Restore the expanded state from before filtering.
"unchanged"—Leave the expanded state unchanged.

expandMatches?


boolean


false

Determines whether matching nodes expand to display their children. Only applicable in "lenient" filter mode.

maxAutoExpandResults?


number

-1

The maximum number of filter results that will be auto-expanded. If the number of results exceeds this value, the expanded state will be reverted according to the expandedOnClear setting. The default value of -1 allows any number of results to be auto-expanded.