REFERENCE
U.GRID_LOOKUP
Summary
Returns intersection points of specified rows and columns
Syntax
=U.GRID_LOOKUP(row_labels, column_labels, data_range, [row_lookup_type], [column_lookup_type], [return_labels], [fail_values])
Parameters
| Parameter | Required | Description |
|---|---|---|
row_labels |
Yes | The row or rows in the data range to be looked up. Set to "replace([num_row_labels],[num_col_labels],[ignore_blanks],[ignore_errors])" for replace logic. If "types" provided and no other params set, then a report of available lookup types is returned |
column_labels |
Yes | The column or columns in the data range to be looked up. Set to the full report that will have cells replaced when using replace logic |
data_range |
Yes | The data on which the row and column lookups will be performed. If only a valid topic is provided, the first page of that report will be used |
[row_lookup_type] |
No | Optional lookup type value to indicate the match logic to be applied to row labels. See table of valid values with descriptions in examples to the left |
[column_lookup_type] |
No | Optional lookup type value to indicate the match logic to be applied to column labels. See table of valid values with descriptions in examples to the left |
[return_labels] |
No | If set to TRUE then row and column labels are included in the result. Default is TRUE when replace logic invoked |
[fail_values] |
No | If set then specified value will be returned for failed lookups. By default an #N/A error is returned for failed lookups |
Behavior
The documented public interface is supported by the current U Add-in source signature and the maintained Usage Examples workbook. Optional parameters are shown in square brackets in the syntax above; omit the brackets when entering a formula.
Return Value
Returns the function result or action status described by the formula and parameters above. The maintained sources do not define a narrower, stable return contract for this function.
Examples
Notes
- Formula examples are preserved from maintained workbook usage and normalized to the current
U.prefix. - Complete formulas demonstrate working patterns; they do not imply that undocumented option values are supported.
- Where maintained sources do not specify every accepted value, default, or error message, this page does not infer one.
- For functions that perform actions, use a visible trigger or supported block/throttle parameter to avoid unintended repetition during recalculation.
Related
- Concept: Grids, Tables, and Array Shaping
- Concept: Dynamic Ranges and Spill Results
- How-to: Build a Pivot-Style Grid
- Example: Live Pivot-Style Grid