VLOOKUP Function (Gnumeric)
Learn the VLOOKUP function in Gnumeric: Vertical search and reference to indicated cells.
Reference checked: Examples have not been run in this spreadsheet application. How we verify guides
The VLOOKUP function in Gnumeric is used for this task: Vertical search and reference to indicated cells. Look up a price using an exact match in the first column.
This guide explains how to read the formula, reproduce a concrete example, interpret its result and recognize common input mistakes.
Syntax and arguments
The worked formula below shows the argument order used for this example. Consult the linked software-specific function reference for optional parameters and edge cases.
Gnumeric formulas normally use commas (,) between arguments. These examples are written for Gnumeric rather than copied unchanged from LibreOffice Calc.
Worked example
For a product lookup, enter the following into cells F1:G3:
| F (Product) | G (Price) |
|---|---|
| Apple | 5 |
| Pear | 8 |
| Plum | 4 |
=VLOOKUP("Pear",F1:G3,2,0)
Expected result: 8.
Why it works: Look up a price using an exact match in the first column. The specified sample table supplies the referenced cells.
Another practical example
Practice inputs: F1:G3 has Apple/5, Pear/8, Plum/4 in rows 1–3.
=VLOOKUP("Apple",F1:G3,2,FALSE())
Expected result: 5.
An exact match in the first column finds Apple, then returns its price from column 2.
What to watch for
The lookup key must be in the first column of the specified range. FALSE selects an exact match.
For LibreOffice Calc formulas, separators are commonly semicolons; the Gnumeric examples here use commas. The arithmetic or official reference supplies the expected result, but Gnumeric has not been executed for this review.
How to use it in your own spreadsheet
- Identify the cells or inputs that correspond to the sample values above.
- Enter the formula in an empty cell, changing the references or literal values to match your sheet.
- Compare the output with a manual check on a small known example.
- Extend the formula to a larger dataset only after you understand the result.
Common problems and practical checks
- Use the correct lookup column or return range, and use exact-match options where appropriate.
- Check for duplicate keys, leading spaces and numbers stored as text in lookup data.
- A pasted formula may produce an error when it uses the other program’s argument separator or unsupported options.
Lookup tip: Use exact matching for product codes or identifiers unless you have deliberately sorted your data for approximate matching. Check the behavior when no match exists.
Related functions
Documentation and verification
- Gnumeric official function reference
- Gnumeric function catalog
- The function name was checked against the official reference. A comparable example passed in LibreOffice Calc 25.2, but the example was not executed in this application. Confirm on your installed version before depending on it.