# VLOOKUP

lookup · from excel · excel: verified match · sheets: not yet compared

looks up value in first column of range and returns value from specified column

## signature

```
VLOOKUP(lookup_value, table_array, col_index_num, [range_lookup])
```

returns: `any`

## arguments

- lookup_value: any — required
- table_array: range — required
- col_index_num: number — required
- range_lookup: boolean — optional, defaults to 1

## examples

formula and result, asserted in the engine test suite.

| formula | result | with |
| --- | --- | --- |
| `=VLOOKUP("south", R2:S4, 2, FALSE)` | `200` | R2=north, R3=south, R4=north, S2=100, S3=200, S4=300 |
| `=VLOOKUP(25, A1:B5, 2, TRUE)` | `4` | A1=10, A2=20, A3=30, A4=40, A5=50, B1=2, B2=4, B3=6, B4=8, B5=10 |

## related

- [ADDRESS](https://deepcalc.com/functions/address.md) — returns a cell address as text from row and column numbers
- [AREAS](https://deepcalc.com/functions/areas.md) — returns the number of areas in a reference
- [HLOOKUP](https://deepcalc.com/functions/hlookup.md) — searches first row and returns matching value
- [HYPERLINK](https://deepcalc.com/functions/hyperlink.md) — the text a link displays — clickability is the renderer's
- [INDEX](https://deepcalc.com/functions/index.md) — returns value at row and column in range
- [INDIRECT](https://deepcalc.com/functions/indirect.md) — returns reference specified by text string
- [LOOKUP](https://deepcalc.com/functions/lookup.md) — looks up value in one-row or one-column range
- [MATCH](https://deepcalc.com/functions/match.md) — returns position of value in a range

## navigate

- [all lookup functions](https://deepcalc.com/functions/lookup-functions.md)
- [function index](https://deepcalc.com/functions.md) — all 598 functions
- [error values](https://deepcalc.com/errors.md) · [concepts](https://deepcalc.com/concepts.md) · [limits](https://deepcalc.com/limits.md)
- [everything in one file](https://deepcalc.com/llms-full.txt)

source: https://deepcalc.com/functions/vlookup