Last updated:
Filter
The Filter control filters a dataset by applying a value-based condition on one column (header) from a dataclip, and only lets matching data through to linked controls. It doesn’t transform data itself: it restricts what connected controls see.
| Setting | Required | Description |
|---|---|---|
| Input type | Yes | How the filter value is provided: Input, Variable, UserId, or Username. |
| Default value | No | The filter’s initial value, when using the Input type. |
| Visible | No | Whether the control is shown on the dashboard. |
Mappings
Section titled “Mappings”| Mapping | Required | Description |
|---|---|---|
| FilterValue | Depends | The value used for filtering: typically required for the Input type. |
Only one condition is supported per control; use multiple Filter controls to combine several conditions.
Events
Section titled “Events”| Event | Description |
|---|---|
| On update | Triggered when the filter value changes as a result of a mapping update. |
- Use multiple Filter controls to simulate multi-condition filtering.
- Set Visible to false when the filter is static or user-based, and not meant to be changed by the user.
- Prefer UserId or Username for security-related filtering.
- Make sure the selected header’s data type matches the filter value’s type.