XMATCH Function in Apple Numbers: Syntax, Examples and Compatibility
Use XMATCH in Apple Numbers to find the relative position of a matching item, including from the end of a list. Two original examples, expected results, cautions and official software documentation.
Verification status: Official documentation referenced; example outcomes independently reasoned or arithmetically checked where stated. Not executed in Apple Numbers. How formula examples are checked
Quick answer: find the relative position of a matching item, including from the end of a list in Apple Numbers. The reproducible examples below use explicit values so the formula’s meaning is testable without a large workbook.
Evidence: The function name and syntax are documented in the linked vendor function reference. Expected outputs were independently reasoned or checked outside the application. These are not native Apple Numbers test results. A guide being published here does not certify every software release or file-import scenario.
Syntax and arguments
=XMATCH(lookup_value, lookup_array, [match_mode], [search_mode])
Exact match (0) is the default. Search mode -1 searches from last to first; optional approximate and binary modes have different rules.
Best use case: Find the relative position of a matching item, including from the end of a list.
Set up the example sheet
Enter A2=Pen, A3=Pad, A4=Pen, and A5=Box. These are product codes from a small transaction log.
Enter the formula in an unused cell. For a formula returning several values, leave an unobstructed area where those values can expand. These formulas use comma argument separators in a typical English-language locale; commas or semicolons inside quoted text are data, not argument separators. Adapt the separator if your regional settings require it.
Worked example 1: XMATCH with known input
=XMATCH("Pad",A2:A5)
Expected output: 2.
Pad is the second value within the searched range A2:A5.
Worked example 2: a second XMATCH case
=XMATCH("Pen",A2:A5,0,-1)
Expected output: 3.
The reverse search finds the last Pen, at the third position in the range, cell A4.
Compare both results before replacing literal values or short sample ranges with your own workbook data. For a spilling formula, compare every output cell, not only the top-left result.
Practical advice and troubleshooting
When this formula helps: Use XMATCH to get a position; wrap it in INDEX when you need an aligned value from another column.
Important edge case: Binary search modes require correctly sorted data; selecting them for unsorted keys can silently return an incorrect answer.
If the result differs, first verify the text-versus-number types of the input cells, the argument separators for your locale, and the range size. For dynamic arrays, inspect occupied cells in the output area. An error that looks like a missing function may reflect a software version rather than incorrect data.
Compatibility and version considerations
The current official Apple Numbers function index includes this function. Table-relative references and current Numbers versions must be checked when transferring formulas from Excel. Google Sheets currently lists MATCH and XLOOKUP but does not list XMATCH in its official Sheets catalogue. Do not relabel an XMATCH formula as a directly supported Google function. The Excel/Google comparison is background only, not a claim of identical behavior in Apple Numbers.
This function appears in the current Apple Numbers catalogue; confirm your installed Numbers version before expecting the same dynamic-array behavior as Excel.
Function availability and parameter behavior must be judged for the specific application and release; a function documented in one spreadsheet does not automatically work in another.
Application-specific source note: The current official Apple Numbers function index includes this function. Table-relative references and current Numbers versions must be checked when transferring formulas from Excel.
Formula separator: These examples use commas for the function-argument separators. Locale settings can change entry conventions.
Related guides and official documentation
-
Apple Numbers documentation for XMATCH — function syntax and current vendor information.
Editorial verification: Function name checked in official vendor catalogue on 2026-10-12. The two example outputs are independently reasoned; no native application run, screenshot, or version-specific output is claimed. Review the editorial testing standards if you require stronger proof before importing a workbook.