# @tanstack/react-virtual

> Headless UI for virtualizing scrollable elements in React

Latest version **3.14.12** (published 2026-09-11) · MIT license · 0 weekly downloads

## Install

```sh
npm install @tanstack/react-virtual
pnpm add @tanstack/react-virtual
yarn add @tanstack/react-virtual
bun add @tanstack/react-virtual
```

## Health

**Score 55/100 (C)** — status: active.

Positive: no vulnerabilities; recently updated; high maintenance score.

Warnings: low downloads; no types; no esm support.

## Facts

| | |
|---|---|
| Version | 3.14.12 |
| Published | 2026-09-11 |
| First published | 2022-02-07 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 0 |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 7104 |
| Author | Tanner Linsley |
| Maintainers | tannerlinsley, alemtuzlak, kevinvandy |
| Keywords | react, vue, solid, virtual, virtual-core, datagrid |

## Links

- npm: https://www.npmjs.com/package/@tanstack/react-virtual
- Repository: https://github.com/TanStack/virtual
- Homepage: https://tanstack.com/virtual
- Funding: https://github.com/sponsors/tannerlinsley
- npm.io page: https://npm.io/package/@tanstack/react-virtual

## Alternatives

- [@lexical/table](https://npm.io/package/@lexical/table.md) — 3.0M weekly downloads
- [mantine-datatable](https://npm.io/package/mantine-datatable.md) — 98.2K weekly downloads
- [react-native-collapsible-tab-view](https://npm.io/package/react-native-collapsible-tab-view.md) — 70.6K weekly downloads
- [@handsontable/vue3](https://npm.io/package/@handsontable/vue3.md) — 16.1K weekly downloads
- [vuewordcloud](https://npm.io/package/vuewordcloud.md) — 7.2K weekly downloads

## Recent versions

- 3.14.12 (latest) — 2026-09-11
- 3.0.0-beta.68 (beta) — 2023-10-22
- 3.0.0-alpha.2 (alpha) — 2022-06-02
- 3.14.11 — 2026-09-07
- 3.14.10 — 2026-08-18
- 3.14.9 — 2026-07-28
- 3.14.8 — 2026-07-22
- 3.14.7 — 2026-07-20
- 3.14.6 — 2026-07-12
- 3.14.5 — 2026-06-30
- 3.14.4 — 2026-06-26
- 3.14.3 — 2026-06-15
- 3.14.2 — 2026-06-02
- 3.14.1 — 2026-06-01
- 3.14.0 — 2026-06-01
- … 122 more at https://npm.io/package/@tanstack/react-virtual/versions

## README

<div align="center">
  <picture>
    <source
      media="(prefers-color-scheme: dark)"
      srcset="https://tanstack.com/api/readme/virtual.png?theme=dark"
    />
    <source
      media="(prefers-color-scheme: light)"
      srcset="https://tanstack.com/api/readme/virtual.png"
    />
    <img
      src="https://tanstack.com/api/readme/virtual.png"
      alt="TanStack Virtual"
      width="900"
    />
  </picture>
</div>

<br />

<div align="center">
	<a href="https://npmjs.com/package/@tanstack/virtual-core" target="\_parent">
  <img alt="npm downloads" src="https://img.shields.io/npm/dm/@tanstack/virtual-core.svg" />
</a>
	<a href="https://github.com/tanstack/virtual" target="\_parent">
  <img alt="github stars" src="https://img.shields.io/github/stars/tanstack/virtual.svg?style=social&label=Star" />
</a>
<a href="https://bundlephobia.com/result?p=@tanstack/virtual-core@latest" target="\_parent">
  <img alt="bundle size" src="https://badgen.net/bundlephobia/minzip/@tanstack/virtual-core@latest" />
</a>
</div>

<div align="center">
	<a href="#badge">
    <img alt="semantic-release" src="https://img.shields.io/badge/%20%20%F0%9F%93%A6%F0%9F%9A%80-semantic--release-e10079.svg">
  </a>
	<a href="https://bestofjs.org/projects/tanstack-virtual">
		<img alt="Best of JS" src="https://img.shields.io/endpoint?url=https://bestofjs-serverless.now.sh/api/project-badge?fullName=TanStack%2Fvirtual%26since=daily" alt="Best of JS"/>
	</a>
	<a href="https://twitter.com/tan_stack">
		<img src="https://img.shields.io/twitter/follow/tan_stack.svg?style=social" alt="Follow @TanStack"/>
	</a>
</div>

<div align="center">

### [Become a Sponsor!](https://github.com/sponsors/tannerlinsley/)

</div>

# TanStack Virtual

A headless, framework‑agnostic virtualization library for rendering massive lists, grids, and tables at 60FPS while giving you full control over markup and styles.

- Framework‑agnostic & headless
- Virtualizes vertical, horizontal & grid layouts with a single hook/function
- Lightweight (10–15kb) yet powerful, with dynamic & measured sizing support
- Smooth 60FPS scrolling with sticky items and window‑scrolling utilities

### <a href="https://tanstack.com/virtual" >Read the docs →</a>

## Get Involved

- We welcome issues and pull requests!
- Participate in [GitHub discussions](https://github.com/TanStack/virtual/discussions)
- Chat with the community on [Discord](https://discord.com/invite/WrRKjPJ)
- See [CONTRIBUTING.md](./CONTRIBUTING.md) for setup instructions

## Partners

<table align="center">
  <tr>
    <td>
      <a href="https://www.coderabbit.ai/?via=tanstack&dub_id=aCcEEdAOqqutX6OS" >
        <picture>
          <source media="(prefers-color-scheme: dark)" srcset="https://tanstack.com/assets/coderabbit-dark-D643Zkrv.svg" />
          <source media="(prefers-color-scheme: light)" srcset="https://tanstack.com/assets/coderabbit-light-CIzGLYU_.svg" />
          <img src="https://tanstack.com/assets/coderabbit-light-CIzGLYU_.svg" height="40" alt="CodeRabbit" />
        </picture>
      </a>
    </td>
    <td>
      <a href="https://www.cloudflare.com?utm_source=tanstack">
        <picture>
          <source media="(prefers-color-scheme: dark)" srcset="https://tanstack.com/assets/cloudflare-white-Co-Tyjbl.svg" />
          <source media="(prefers-color-scheme: light)" srcset="https://tanstack.com/assets/cloudflare-black-6Ojsn8yh.svg" />
          <img src="https://tanstack.com/assets/cloudflare-white-Co-Tyjbl.svg" height="60" alt="Cloudflare" />
        </picture>
      </a>
    </td>
  </tr>
</table>
  
 
<div align="center">
<img src="./media/partner_logo.svg" alt="Virtual & you?" height="65">
<p>
We're looking for TanStack Virtual Partners to join our mission! Partner with us to push the boundaries of TanStack Virtual and build amazing things together.
</p>
<a href="mailto:partners@tanstack.com?subject=TanStack Virtual Partnership"><b>LET'S CHAT</b></a>
</div>
  
## Explore the TanStack Ecosystem

- <a href="https://github.com/tanstack/config"><b>TanStack Config</b></a> – Tooling for JS/TS packages
- <a href="https://github.com/tanstack/db"><b>TanStack DB</b></a> – Reactive sync client store
- <a href="https://github.com/tanstack/devtools"><b>TanStack DevTools</b></a> – Unified devtools panel
- <a href="https://github.com/tanstack/form"><b>TanStack Form</b></a> – Type‑safe form state
- <a href="https://github.com/tanstack/pacer"><b>TanStack Pacer</b></a> – Debouncing, throttling, batching <br/>
- <a href="https://github.com/tanstack/query"><b>TanStack Query</b></a> – Async state & caching
- <a href="https://github.com/tanstack/ranger"><b>TanStack Ranger</b></a> – Range & slider primitives
- <a href="https://github.com/tanstack/router"><b>TanStack Router</b></a> – Type‑safe routing, caching & URL state
- <a href="https://github.com/tanstack/router"><b>TanStack Start</b></a> – Full‑stack SSR & streaming
- <a href="https://github.com/tanstack/store"><b>TanStack Store</b></a> – Reactive data store
- <a href="https://github.com/tanstack/table"><b>TanStack Table</b></a> – Headless datagrids

… and more at <a href="https://tanstack.com"><b>TanStack.com »</b></a>

<!-- Use the force, Luke -->

---
_Source: https://npm.io/package/@tanstack/react-virtual · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._
