Skip to content
⚛️ Hooks for building fast and extendable tables and datagrids for React
JavaScript HTML CSS
Branch: master
Clone or download
Latest commit dd0d6d6 Nov 14, 2019
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github ci: setup github actions continuous integration workflow (#1578) Oct 9, 2019
archives/v6-examples Fix sandbox config to proper extension for codesandbox (#1323) Apr 28, 2019
configs/tests Fix sandbox loop protection Oct 3, 2019
docs Update Nov 5, 2019
examples Update syntax in examples (#1631) Nov 5, 2019
media fix: better naming, fix header regen, getSubRows, getRowPathID Aug 26, 2019
src Fix simple typo in comments. (#1606) Nov 5, 2019
www Create _redirects Feb 11, 2019
.babelrc fix(usegroupby): fix useGroupBy, add grouping example and fix some tests Jul 30, 2019
.eslintrc Add prettier format Jul 29, 2019
.gitattributes Fixed text mismatch when doing SSR (#957) May 24, 2018
.gitignore Remove package-lock.json (#1579) Oct 9, 2019
.huskyrc.js Test Nov 5, 2019
.npmrc Remove package-lock.json (#1579) Oct 9, 2019 docs(changelog): update changelog Sep 13, 2019 Create (#1452) Aug 15, 2019 docs: docs Aug 15, 2019
LICENSE Revert "Init" May 12, 2017 Update Nov 14, 2019 Add selectedFlatRows (#1597) Oct 14, 2019
commitlint.config.js chore(commitlint): add deps, config, and git hook (#1419) Jul 30, 2019
index.d.ts remove Record from HeaderProps and CellProps (#1601) Nov 5, 2019
jest.config.js Add prettier format Jul 29, 2019
lint-staged.config.js Add prettier format Jul 29, 2019
package.json Merge branch 'master' of Nov 5, 2019
prettier.config.js Fix hook defaults Jul 29, 2019
react-table-config.d.ts fix react-table-config.d.ts (#1582) Oct 9, 2019
rollup.config.js chore: user terser Oct 2, 2019
tsconfig.json test: validate typings using dtslint (#1581) Oct 9, 2019
tslint.json refactor: update complex types to use Array<> syntax (#1587) Oct 10, 2019
yarn.lock test: validate typings using dtslint (#1581) Oct 9, 2019

React Table Header

Hooks for building lightweight, fast and extendable datagrids for React

#TanStack GitHub Actions CI Bundlephobia NPM Package Join the community on Spectrum GitHub Stars Twitter Followers

Enjoy this library? Try them all! React Query, React Form, React Charts

Become a Sponsor


  • Lightweight (4kb - 9kb depending on features and tree-shaking)
  • Headless (100% customizable, Bring-your-own-UI)
  • Auto out of the box, fully controllable API
  • Sorting (Multi and Stable)
  • Filters
  • Pivoting & Aggregation
  • Row Selection
  • Row Expansion
  • Column Ordering
  • Animatable
  • Virtualizable
  • Resizable
  • Server-side/controlled data/state
  • Extensible via hook-based plugin system
  • "Why I wrote React Table and the problems it has solved for" by Tanner Linsley

News / Q&A

What is the current state of React Table?

React Table v7 is still under active development, and its API is still changing, albeit only slightly. For this reason, it is currently in an beta release state. It's estimated that it will be fully released as a stable version sometime during October 2019.

Should I use v7@beta in production?

You can use it in production as long as you lock in the beta version in your package.json and also accept that there may be unlikely, but possible bug fixes and/or API changes before it's official release.

I'm still using v6, what should I do?

v6 is a great library and is still the default install for react-table, however, I do not intend on offering any long-term support for it. If you intend to keep using v6, I recommend maintaining your own fork of the library and keeping it up to date for your version of React.

Where are the docs for the older v6 version?

Please visit the v6 branch

I want to migrate from v6 to v7. How do I do that?

The differences between the 2 versions are incredibly massive. Unfortunately, I cannot write a one-to-one upgrade guide for any of v6's API, simply because much of it is irrelevant with v7's headless approach. The best approach for migrating to v7 is to learn its API by reading the documentation and then following some of the examples to begin building your own table component.

In case you would need to have both v6 and v7 in one app during the migration process (large codebase, complex use cases), you can install an official react-table-v6 package alongside the react-table.


  • Installation - Walk through how to install React Table
  • Concepts - Read how React Table works and how you can use it better
  • Examples - Experience and learn from some examples and guides of how to use React Table and implement common patterns
  • API - Get to know React Table's API, how to use it and how to extend its functionality
  • Contributing - Become familiar with how to contribute back to React Table
  • Code of Conduct - Be a good React Table citizen by following these repository rules


This library is being built and maintained by me, @tannerlinsley and I am always in need of more support to keep this project afloat. If you would like to get additional support, add your logo or name on this README, or simply just contribute to my open source Sponsorship goal, visit my Github Sponsors page!

Become a Sponsor!
Become a Sponsor!
Become a Sponsor!
Become a Sponsor!
Become a Supporter!
  • Hugo Meissner
  • Benoit Leger-Derville
  • Thomas Funk
  • Dan Houle
  • David Pickut
  • Jordan Soltman
  • Robert Tajnšek
  • Pekka Tapani
Become a Fan!

Become a Sponsor

You can’t perform that action at this time.