FILTER

FILTER('Node', "Level", FilterValue [, "FilterOperation"])

In Filtering & data shaping

The FILTER function returns only the rows of a node that match a specified condition. Rows that do not satisfy the filter condition are removed from the result.

Use this function to restrict calculations to a subset of your data, for example by selecting specific years, regions, or products: FILTER('Sales', "Year", "2025").

Parameters

NodeNode referenceRequired
Input node, specified in single quotes (e.g. 'Revenue')
LevelLevel nameRequired
The level by which the input node shall be filtered, specified in double quotes (e.g. "Year", "Region")
FilterValueLevel value / Level value listRequired
The value(s) to filter by. A single level value or a list of level values (e.g. "2026" or ["EMEA", "APAC"])
FilterOperationStringOptional
Defines how values are compared to the filter. Valid values: "EQ", "NEQ", "LT", "LTE", "GT", "GTE" Default: "EQ" (equal).

See also: Comparisons & boolean operators

Output shape

Dimensionality
Same dimensions as the input node
Values
Only rows fulfilling the filter condition are returned
Row count
Reduced, non-matching rows are removed

Watch out

  • FILTER removes rows that do not match the filter condition.
  • When using a list of values, rows matching any value in the list are kept.
  • Filters can be nested to restrict multiple dimensions.
  • The level specified in the filter must exist in the input node.

Examples

Input node: 'Sales'

YearProductValue
2025Alpha100
2025Beta200
2026Alpha150
2026Beta300
2027Alpha10

Filter to a single value

Keep only rows for 2025.

Formula: FILTER('Sales', "Year", "2025")

YearProductFILTER Result
2025Alpha100
2025Beta200

Exclude specific values with NEQ (not equal)

Return all rows except 2025 and 2026.

Formula: FILTER('Sales', "Year", ["2025", "2026"], "NEQ")

YearProductFILTER Result
2027Alpha10

Chaining filters

You can nest FILTER calls to narrow down on multiple dimensions at once.

Formula: FILTER(FILTER('Sales', "Year", "2026"), "Product", "Alpha")

YearProductFILTER Result
2026Alpha150

Using a project variable as the filter value

Instead of hardcoding a level value for a specific year, you can use a project variable so the filter updates automatically when the variable changes.

Formula: FILTER('Sales', "Year", "$FC_End")

This returns only rows where Year equals the current value of $FC_End, no formula change needed when the planning horizon shifts.

See also: Project Variables

See also

IF
Apply conditional logic without removing rows.
LEVELFILTER
When the condition depends on comparing level values rather than matching explicit values.
EXPANDSINGLE
Expand to specific level values instead of removing rows.
DATA
Load source data before filtering.
Was this page helpful?