XLOOKUP Function in Google Sheets: Formula, Examples & Troubleshooting
Learn the XLOOKUP formula in Google Sheets: return the aligned value for a searched key, with reproducible examples, expected answers and compatibility cautions.
Verification status: Official documentation referenced; example outcomes independently reasoned or arithmetically checked where stated. Not executed in Google Sheets. How formula examples are checked
Quick answer: Use XLOOKUP to return the aligned value for a searched key. The example below supplies exact inputs and independently calculated expected results, so you can check your formula before replacing the demonstration values with real workbook data.
Verification: The function is covered by a vendor reference or its published formula catalogue. The worked outputs here are independently reasoned, not screenshots or native test results from Google Sheets. Check release-specific support and argument details in the referenced vendor help.
Syntax and arguments
=XLOOKUP(search_key, lookup_range, result_range, [missing_value], [match_mode], [search_mode])
Search the lookup range; return the aligned result; optional missing and match arguments. In formula syntax, square brackets mark optional arguments; do not type square brackets into an ordinary formula unless the particular function requires array notation. The separator shown is for the example locale and might change with spreadsheet settings.
When to use it: Confirm your version supports XLOOKUP and do not assume match_mode/search_mode behave identically across apps.
Prepare the example inputs
Create a blank Google Sheets spreadsheet, enter the data as values (not quoted numeric strings), and use a clear output cell. Confirm File → Settings → Locale before comparing punctuation-sensitive formulas.
For the formulas that reference cells, enter this small dataset into A1:F9 (the first row contains headings). The Amount and Units columns are numbers; the team, status, item and agent columns are text. Keep the calculation cell outside A1:F9 so it cannot overwrite an input.
| Row | A · Item | B · Team | C · Status | D · Amount | E · Units | F · Agent |
|---|---|---|---|---|---|---|
| 1 | Item | Team | Status | Amount | Units | Agent |
| 2 | Pen | East | Paid | 120 | 12 | Ana |
| 3 | Pad | West | Pending | 75 | 5 | Bo |
| 4 | Box | East | Paid | 210 | 7 | Ana |
| 5 | Tape | North | Paid | 90 | 0 | Cy |
| 6 | Folder | West | Paid | 150 | 3 | Bo |
| 7 | Pen | East | Pending | 60 | 8 | Dee |
| 8 | Pad | West | Paid | 125 | 12 | Ana |
| 9 | Box | North | Pending | 80 | 4 | Cy |
Worked example: exact formula and expected output
=XLOOKUP("Pad",A2:A9,D2:D9,"Missing")
Expected result: 75. The first Pad matches row 3, so aligned Amount returns 75.
- Select an unused output cell (for example H2 if the practice table occupies A1:F9).
- Enter the formula exactly as shown, including the opening equals sign and quoted text.
- Compare the displayed answer to the expected result, then inspect the source cells if it differs.
For a range formula, the row numbers include data rows only unless the example explicitly refers to headers. A result that looks plausible may still be wrong if it references the wrong column.
Second example: a different input
=XLOOKUP("Stapler",A2:A9,D2:D9,"Missing")
Expected result: Missing. No item is named Stapler, so the supplied missing label is returned.
This independent check can be entered in the next blank output cell; it helps distinguish a genuine calculation issue from a reference or paste-location mistake.
Important edge cases and a common mistake
Watch out: For repeat keys, a first-match lookup is not an aggregation; SUMIF is better for totals by item.
Google Sheets may expand range outputs automatically and apply locale-aware parsing. A workbook imported from Excel can behave differently after conversion; recalculate the sample inside the target file.
Troubleshooting in Google Sheets
In Sheets, a #N/A often indicates that a lookup found no match or a filter returned no matching row. #REF! may indicate that an array result could not expand; #ERROR! can indicate incorrect formula syntax. Open the cell error tooltip and confirm the spreadsheet locale.
If you get the wrong answer but no error, try these checks in order: (1) evaluate the simplified first example; (2) confirm the cell values and data types; (3) check the exact row and column boundaries; (4) verify quoted text, comparison operators and separators; (5) only then add more criteria or nested functions.
For a reproducible comparison with another spreadsheet product, use the same input values in both applications and record the installed version and locale. Different default matching behavior or handling of empty values can be a migration issue rather than a mathematical disagreement.
Moving this formula between spreadsheet programs
Google Sheets may use ARRAYFORMULA and different regex or sorting conventions than Excel. Do not paste a LibreOffice formula with semicolon argument separators into a US-locale Sheets file without reviewing the syntax.
Related guides already published for this function: Microsoft Excel | LibreOffice Calc | Gnumeric | PlanMaker 2026 | ONLYOFFICE Spreadsheet Editor
If a comparison tool says Not researched here, that means we do not yet have a checked guide for that software. It does not mean the software lacks this function. See the 12-program comparison tool for a guide-coverage matrix.
Official reference and editorial verification
- Google Docs Editors Help — Google Sheets function list
- Function comparison tool
- How we verify function guides
Evidence level: Vendor-published function catalogue / formula overview, checked for this editorial batch on October 11, 2026; example outputs verified by direct reasoning/arithmetic where applicable. No execution in Google Sheets was performed. Some platform-, language- and release-specific edge cases remain for native testing.