VLOOKUP Function in Apple Numbers: Formula, Examples & Troubleshooting
Learn the VLOOKUP formula in Apple Numbers: find a value in the first table column and return another column, 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 Apple Numbers. How formula examples are checked
Quick answer: Use VLOOKUP to find a value in the first table column and return another column. 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 Apple Numbers. Check release-specific support and argument details in the referenced vendor help.
Syntax and arguments
=VLOOKUP(search_key, range, index, [is_sorted])
Lookup key; table whose first column holds the key; 1-based output column index; exact-match flag. 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: A fixed column number can break if columns are inserted; XLOOKUP or INDEX+MATCH reduces that risk.
Prepare the example inputs
Create a new Numbers document and put the practice fixture in a single Numbers table starting in A1. In the English documentation, formulas use commas; other locales can change punctuation. Enter each formula in a blank cell of the same table.
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
=VLOOKUP("Pad",A2:D9,4,FALSE)
Expected result: 75. The first Pad occurs in row 3, where Amount is 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
=VLOOKUP("Box",A2:D9,4,FALSE)
Expected result: 210. The first Box occurs in row 4 with amount 210.
Check this independent example with the same table data or literal inputs, recording the Numbers version if a workbook is being migrated.
Important edge cases and a common mistake
Watch out: Always set FALSE/0 for exact matches on unsorted identifiers; omitted matching mode may be approximate.
Numbers uses table-relative and structured references, so the same formula may require adapting when ranges move to different tables. Apple’s function help specifies the current argument names and supported options.
Troubleshooting in Apple Numbers
Numbers can show an error popover and highlights malformed formula references. Confirm that practice inputs occupy cells within a single table and are not merely displayed as formatted text; check Formula Editor for erroneous references.
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
Apple Numbers uses tables with named column references and also supports ordinary cell references within a table. Do not assume imported Excel formulas preserve every argument or locale-specific separator. Numbers SORT uses 1/-1 direction, whereas Sheets uses TRUE/FALSE.
Related guides already published for this function: Microsoft Excel | Google Sheets | WPS Spreadsheet | Collabora Office Calc | LibreOffice Calc
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
- Apple Support — Numbers formulas and functions guide
- 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 Apple Numbers was performed. Some platform-, language- and release-specific edge cases remain for native testing.