KEEPFILTERS is a CALCULATE modifier used to change the way CALCULATE merges new filters with the outer filter context. Indeed, the default behavior of CALCULATE is to override existing filters. By using KEEPFILTERS you ask CALCULATE to add the new filter to the outer filter context, instead of overriding the outer filter.
Single column filters
Let us start by looking at the effect of using KEEPFILTERS in a simple measure that uses CALCULATE with a single column filter. AlwaysRed shows the sales amount of red products, by forcing the Product[Color] to be read while the value of Sales Amount is being computed:
AlwaysRed := CALCULATE ( [Sales Amount], 'Product'[Color] = "Red" )
Bear in mind that the compact syntax of CALCULATE is translated into a longer syntax, because filters in CALCULATE are always tables. If you are not familiar with this concept, you may find more information by reading Introducing CALCULATE in DAX. The following is an equivalent formulation of the same measure:
AlwaysRed := CALCULATE ( [Sales Amount], FILTER ( ALL ( 'Product'[Color] ), 'Product'[Color] = "Red" ) )
The presence of ALL – which is explicit in this latter version while being implicit in the earlier version – means that the existence of an outer filter over Product[Color] is ignored by CALCULATE. This forces the color to be red regardless of any outer filter.
OnlyRed := CALCULATE ( [Sales Amount], KEEPFILTERS ( 'Product'[Color] = "Red" ) )
You can see that the two measures behave differently regarding the outer filter. AlwaysRed always returns the sales volume of red products, as it replaces the outer filter with the red color. OnlyRed on the other hand returns a value only when red is already selected in the outer filter.
You can obtain this behavior by using different techniques, that you can find in many articles and blogs written prior to the introduction of KEEPFILTERS in DAX. By using VALUES as an additional filter in the compact syntax, or by replacing ALL with VALUES in the extended syntax, you achieve the same goal:
OnlyRed Values := CALCULATE ( [Sales Amount], Product[Color] = "Red", VALUES ( 'Product'[Color] ) )
OnlyRed Values Ext := CALCULATE ( [Sales Amount], FILTER ( VALUES ( 'Product'[Color] ), Product[Color] = "Red" ) )
As you can see, the three measures behave the same way, even though the version using KEEPFILTERS is usually more efficient.
Multiple column filters
KEEPFILTERS can also be used with conditions involving multiple columns. For example, if you want to test both the color and the brand in the same condition, you can author the following measure:
AlwaysRedContoso := CALCULATE ( [Sales Amount], OR ( 'Product'[Color] = "Red", 'Product'[Brand] = "Contoso" ) )
When used in a matrix, it shows the same number on each row. Indeed, both the filter on the brand and the filter on the color were replaced.
Below, we see a scenario where KEEPFILTERS merges the filter on both columns with the outer filter context:
OnlyRedContoso := CALCULATE ( [Sales Amount], KEEPFILTERS ( OR ( 'Product'[Color] = "Red", 'Product'[Brand] = "Contoso" ) ) )
This results in blanks everywhere except on the intersection of Contoso and Red.
As was the case with the single column scenario, you can obtain the same behavior by using multiple filters in CALCULATE. Alas, in the multiple column scenario you cannot leverage VALUES, because VALUES works with a single column only. However, you can use SUMMARIZE to obtain the desired effect, both with the compact and with the extended syntax:
OnlyRedContoso SUMMARIZE := CALCULATE ( [Sales Amount], OR ( 'Product'[Color] = "Red", 'Product'[Brand] = "Contoso" ), SUMMARIZE ( 'Product', 'Product'[Color], 'Product'[Brand] ) )
OnlyRedContoso SUMMARIZE Ext := CALCULATE ( [Sales Amount], FILTER ( SUMMARIZE ( 'Product', 'Product'[Color], 'Product'[Brand] ), OR ( 'Product'[Color] = "Red", 'Product'[Brand] = "Contoso" ) ) )
KEEPFILTERS in iterators
Monthly Average := AVERAGEX ( KEEPFILTERS ( VALUES ( 'Date'[Month] ) ), [Sales Amount] )
Here, KEEPFILTERS is used to modify the semantics of the context transition induced by the Sales Amount measure reference. Although that aspect is too advanced for this introductory article, it is a nice transition to a more advanced piece. If you want to better understand when and how to use KEEPFILTERS with iterators, you can find more information here: When to use KEEPFILTERS over iterators.
Changes the CALCULATE and CALCULATETABLE function filtering semantics.
KEEPFILTERS ( <Expression> )
Evaluates an expression in a context modified by filters.
CALCULATE ( <Expression> [, <Filter> [, <Filter> [, … ] ] ] )
Returns all the rows in a table, or all the values in a column, ignoring any filters that might have been applied.
ALL ( [<TableNameOrColumnName>] [, <ColumnName> [, <ColumnName> [, … ] ] ] )
When a column name is given, returns a single column table of unique values. When a table name is given, returns a table with the same columns and all the rows of the table (including duplicates) with the additional blank row if present.
VALUES ( <TableNameOrColumnName> )
Creates a summary of the input table grouped by the specified columns.
SUMMARIZE ( <Table> [, <GroupBy_ColumnName> [, [<Name>] [, [<Expression>] [, <GroupBy_ColumnName> [, [<Name>] [, [<Expression>] [, … ] ] ] ] ] ] ] )
Articles in the DAX 101 series
- Computing running totals in DAX
- Counting working days in DAX
- Summing values for the total
- Year-to-date filtering weekdays in DAX
- Creating a simple date table in DAX
- Automatic time intelligence in Power BI
- Using CONCATENATEX in measures
- Previous year up to a certain date
- Sorting months in fiscal calendars
- Using USERELATIONSHIP in DAX
- Mark as Date table
- Row context in DAX
- Filter context in DAX
- Introducing CALCULATE in DAX
- Understanding context transition in DAX
- Using KEEPFILTERS in DAX
- Variables in DAX
- Using RELATED and RELATEDTABLE in DAX
- Introducing ALLSELECTED in DAX
- Introducing RANKX in DAX