LOOKUPVALUE

Returns the value for the row that meets all criteria specified by one or more search conditions.

Syntax

LOOKUPVALUE(
    <result_columnName>,
    <search_columnName>,
    <search_value>
    [, <search2_columnName>, <search2_value>]…
    [, <alternateResult>]
)

Parameters

Term Definition
result_columnName The name of an existing column that contains the value you want to return. It cannot be an expression.
search_columnName The name of an existing column. It can be in the same table as result_columnName or in a related table. It cannot be an expression.
search_value The value to search for in search_columnName.
alternateResult (Optional) The value returned when the context for result_columnName has been filtered down to zero or more than one distinct value. When not provided, the function returns BLANK when result_columnName is filtered down to zero value or an error when more than one distinct value.

Return value

The value of result_column at the row where all pairs of search_column and search_value have an exact match.

If there's no match that satisfies all the search values, BLANK or alternateResult (if supplied) is returned. In other words, the function won't return a lookup value if only some of the criteria match.

If multiple rows match the search values and in all cases result_column values are identical, then that value is returned. However, if result_column returns different values, an error or alternateResult (if supplied) is returned.

Remarks

  • If there is a relationship between the result and search tables, in most cases, using RELATED function instead of LOOKUPVALUE is more efficient and provides better performance.

  • The search_value and alternateResult parameters are evaluated before the function iterates through the rows of the search table.

  • This function is not supported for use in DirectQuery mode when used in calculated columns or row-level security (RLS) rules.

Example

Examples in this article can be added to the Power BI Desktop sample model. To get the model, see DAX sample model.

The following calculated column defined in the Sales table uses the LOOKUPVALUE function to return channel values from the Sales Order table.

CHANNEL = LOOKUPVALUE('Sales Order'[Channel],'Sales Order'[SalesOrderLineKey],[SalesOrderLineKey])

However, in this case, because there is a relationship between the Sales Order and Sales tables, it's more efficient to use the RELATED function.

CHANNEL = RELATED('Sales Order'[Channel])

See also

RELATED function (DAX)
Information functions