Skip to content
A Bootstrap table built with React.js
Branch: master
Clone or download
Type Name Latest commit message Commit time
Failed to load latest commit information.
__tests__ Test search() instead of _search() Apr 14, 2017
css added showExpandAllHeaderColumn to show/hide header column Oct 17, 2017
dist prod Dec 23, 2017
examples Fixed link to scroll-table.js on the demo page (#1838) Jan 9, 2018
src Merge branch 'fix-pagination' of… Dec 22, 2017
.babelrc unwind babel and local build changes Nov 27, 2017
.eslintrc Loosely compare to null May 11, 2016
.gitignore unwind babel and local build changes Nov 27, 2017
.npmignore complete rewrite of the build system Mar 22, 2016
.travis.yml Expect Node.js version 6 in travis builds Apr 7, 2017 CHANGELOG Jan 3, 2018
LICENSE fix #297 Feb 27, 2016 README Jan 23, 2018
gulpfile.js use scale eddect and remove useless css file May 13, 2017
package.json v4.3.1 Dec 23, 2017
preprocessor.js commit first testing code. Apr 22, 2015
webpack.umd.config.js unwind babel and local build changes Nov 27, 2017
webpack.umd.min.config.js unwind babel and local build changes Nov 27, 2017
yarn.lock upgrade react-modal Dec 12, 2017


react-bootstrap-table2 already released, this project will stop development after 2018Q2

Join the chat at

NPM version Build Status

Dependency Status devDependency Status peerDependency Status
It's a react.js table for bootstrap, named react-bootstrap-table. It's a configurable, functional table component and make you build a Bootstrap Table more efficiency and easy in your React application, However react-bootstrap-table support these features:

  • Striped, borderless, condensed table
  • Column align, hidden, width, sort, title, styling, customization
  • Table scrolling
  • Cell format
  • Pagination
  • Row selection
  • Table Search, Column filter
  • Cell editor
  • Insert & delete Row
  • Export to CSV
  • Rich function hooks
  • Header column span
  • Remote mode
  • Row expand
  • Key board navigation

Example See more about react-bootstrap-table and explore more examples on examples folder
Check the CHANGELOG for more detail release notes.


v4.0.0 released, this release mainly replace react-toastr with react-s-alert

  1. Replace react-toastr by react-s-alert
  2. Use prop-types
  3. Support bootstrap@4 and bootstrap@3 both. If you use 4, please add version='4' on <BootstrapTable>
  4. No important features were implemented, most of bug fixes and improvement

After v2.4.4, we move the css files to dist folder for allowing this repo can be hosted on cdnjs


react-bootstrap-table dependencies on react.js and Bootstrap 3, also written by ES6 and use gulp and browserify for building and bundling.

You can use the following commands to prepare development

$ git clone
$ cd react-bootstrap-table
$ npm install

See the examples for react-bootstrap-table

$ npm start # see all examples, go to localhost:3004



npm install react-bootstrap-table --save

b.Import Module

To use react-bootstrap-table in your react app, you should import it first. You can do this in two ways:

With a module bundler

With a module bundler like webpack that supports either CommonJS or ES2015 modules, use as you would anything else.
You can include source maps on your build system to debug on development. Don't forget to Uglify on production.

// in ECMAScript 6
import { BootstrapTable, TableHeaderColumn } from 'react-bootstrap-table';
// or in ECMAScript 5
var ReactBSTable = require('react-bootstrap-table');  
var BootstrapTable = ReactBSTable.BootstrapTable;
var TableHeaderColumn = ReactBSTable.TableHeaderColumn;
Browser global(window object)

In the dist folder you have a UMD bundle with source maps (react-bootstrap-table.js) as well as a minified version (react-bootstrap-table.min.js).

<script src="path/to/react-bootstrap-table/dist/react-bootstrap-table.min.js" />
  var ReactBsTable = window.BootstrapTable;

The UMD build is also available on npmcdn:

// source maps:
<script src=""></script>
// or use the min version
<script src=""></script>

c.Import CSS

Finally, you need to import the css file to your app:

<!-- we still need bootstrap css -->
<link rel="stylesheet" href="">
<link rel="stylesheet" href="./dist/react-bootstrap-table.min.css">

The CSS files you can find in the css folder.

Quick Demo

// products will be presented by react-bootstrap-table
var products = [{
      id: 1,
      name: "Item name 1",
      price: 100
      id: 2,
      name: "Item name 2",
      price: 100
// It's a data format example.
function priceFormatter(cell, row){
  return '<i class="glyphicon glyphicon-usd"></i> ' + cell;

  <BootstrapTable data={products} striped={true} hover={true}>
      <TableHeaderColumn dataField="id" isKey={true} dataAlign="center" dataSort={true}>Product ID</TableHeaderColumn>
      <TableHeaderColumn dataField="name" dataSort={true}>Product Name</TableHeaderColumn>
      <TableHeaderColumn dataField="price" dataFormat={priceFormatter}>Product Price</TableHeaderColumn>

More react-bootstrap-table examples

The example source codes are in the examples folder folder. Run the following commands for a live demo.

$ git clone
$ cd react-bootstrap-table
$ npm install
$ npm start # after start, open browser and go to http://localhost:3004



Help this project to integrate a better examples demo, add travis & badge, code formatting, give a lot of suggestions and bugs report.
Implement a lots of awesome new feature and also fix some bugs and enhancements.
Parth Prajapati
Help to check issues and give great and useful instructions.
Contribute export csv, multi-search and bug fixing.
Contribute a new colum-filter design and great feedback given.
Bugs report and give some bootstrap and css suggestions actively.
Contribute the edit format & validation on cell editing and row insertion. Improve the custom styling.
Sofia Silva
Bug reports and fixing actively.
Fixing bugs and give improvement for functionality.
Bugs report and enhance the cell formatting.
Implement the TableDataSet component.

You can’t perform that action at this time.