Formualizer Docs
ReferenceFunctionsReference Functions

OFFSET

OFFSET: Returns a reference shifted from a starting reference by rows and columns.

Summary

OFFSET is volatile and returns a reference that can point to a single cell or a resized range, depending on the optional height and width arguments.

Remarks

  • rows and cols shift from the top-left of reference.
  • If omitted, height and width default to the original reference size.
  • Non-positive target coordinates or dimensions return #REF!.
  • Non-numeric offset/size inputs return #VALUE!.
  • In value context, a 1x1 result returns a scalar; larger results spill as an array.

Examples

Move one row down and one column right
Grid
CellValue
Formula
=
Result
Not evaluated yet.
Expected
42
Offset and resize a range
Grid
CellValue
Formula
=
Result
Not evaluated yet.
Expected
16

FAQ

What defaults are used when height and width are omitted?

OFFSET keeps the source reference size, then applies the row/column shift to that same-sized block.

When does OFFSET return #REF!?

It returns #REF! if the shifted start goes to row/column <= 0 or if requested height/width are non-positive.

Runtime metadata

Category

Reference Fns

Signature

OFFSET(arg1: Range (Range), arg2: Number, arg3: Number, arg4?: Number, arg5?: Number)

Arity

min 3, max 5

Arguments

arg1by-ref

Range · Range

arg2

Number · Scalar · coercion NumberStrict

arg3

Number · Scalar · coercion NumberStrict

arg4optional

Number · Scalar · coercion NumberStrict

arg5optional

Number · Scalar · coercion NumberStrict

Caps

PUREVOLATILERETURNS_REFERENCEDYNAMIC_DEPENDENCY

Source

On this page