📄 tanstack/table/v8/docs/api/core/row

File: row.md | Updated: 11/15/2025

Source: https://tanstack.com/table/v8/docs/api/core/row



TanStack

Table v8v8

Search...

+ K

Auto

Log In

TanStack StartRC

Docs Examples GitHub Contributors

TanStack Router

Docs Examples GitHub Contributors

TanStack Query

Docs Examples GitHub Contributors

TanStack Table

Docs Examples Github Contributors

TanStack Formnew

Docs Examples Github Contributors

TanStack DBbeta

Docs Github Contributors

TanStack Virtual

Docs Examples Github Contributors

TanStack Paceralpha

Docs Examples Github Contributors

TanStack Storealpha

Docs Examples Github Contributors

TanStack Devtoolsalpha

Docs Github Contributors

More Libraries

Maintainers Partners Support Learn StatsBETA Discord Merch Blog GitHub Ethos Brand Guide

Documentation

Framework

React logo

React

Version

v8

Search...

+ K

Menu

Getting Started

Core Guides

Feature Guides

Core APIs

Feature APIs

Enterprise

Examples

Framework

React logo

React

Version

v8

Menu

Getting Started

Core Guides

Feature Guides

Core APIs

Feature APIs

Enterprise

Examples

On this page

Row APIs

Copy Markdown

These are core options and API properties for all rows. More options and API properties are available for other table features .

Row API
-------

All row objects have the following properties:

### id

tsx

id: string


id: string

The resolved unique identifier for the row resolved via the options.getRowId option. Defaults to the row's index (or relative index if it is a subRow)

### depth

tsx

depth: number


depth: number

The depth of the row (if nested or grouped) relative to the root row array.

### index

tsx

index: number


index: number

The index of the row within its parent array (or the root data array)

### original

tsx

original: TData


original: TData

The original row object provided to the table.

🧠 If the row is a grouped row, the original row object will be the first original in the group.

### parentId

tsx

parentId?: string


parentId?: string

If nested, this row's parent row id.

### getValue

tsx

getValue: (columnId: string) => TValue


getValue: (columnId: string) => TValue

Returns the value from the row for a given columnId

### renderValue

tsx

renderValue: (columnId: string) => TValue


renderValue: (columnId: string) => TValue

Renders the value from the row for a given columnId, but will return the renderFallbackValue if no value is found.

### getUniqueValues

tsx

getUniqueValues: (columnId: string) => TValue[]


getUniqueValues: (columnId: string) => TValue[]

Returns a unique array of values from the row for a given columnId.

### subRows

tsx

type subRows = Row<TData>[]


type subRows = Row<TData>[]

An array of subRows for the row as returned and created by the options.getSubRows option.

### getParentRow

tsx

type getParentRow = () => Row<TData> | undefined


type getParentRow = () => Row<TData> | undefined

Returns the parent row for the row, if it exists.

### getParentRows

tsx

type getParentRows = () => Row<TData>[]


type getParentRows = () => Row<TData>[]

Returns the parent rows for the row, all the way up to a root row.

### getLeafRows

tsx

type getLeafRows = () => Row<TData>[]


type getLeafRows = () => Row<TData>[]

Returns the leaf rows for the row, not including any parent rows.

### originalSubRows

tsx

originalSubRows?: TData[]


originalSubRows?: TData[]

An array of the original subRows as returned by the options.getSubRows option.

### getAllCells

tsx

type getAllCells = () => Cell<TData>[]


type getAllCells = () => Cell<TData>[]

Returns all of the Cells for the row.

Edit on GitHub

Header

Cell

Partners Become a Partner

Code RabbitCode Rabbit CloudflareCloudflare AG GridAG Grid NetlifyNetlify NeonNeon WorkOSWorkOS ClerkClerk ConvexConvex ElectricElectric SentrySentry PrismaPrisma StrapiStrapi UnkeyUnkey

scarf analytics