Handsontable is a JavaScript/HTML5 Spreadsheet Library for Developers
Failed to load latest commit information.
demo Update demo pages and add numbro to bower dependency. #3487 Jun 24, 2016
dist 0.28.0 Sep 15, 2016
lib Remove numeralJS. #3620 Jun 29, 2016
plugins Replace jQuery to window.jQuery Jun 6, 2016
src 0.28.0 Sep 15, 2016
tasks Added modularization by hot-builder. #2072 Apr 10, 2015
test/jasmine 0.28.0 Sep 15, 2016
.bowerrc refactor Heatmaps demo to use Chroma.js; move to "Integrations" menu Jun 12, 2014
.editorconfig Added .editorconfig file. See http://editorconfig.org/ for details. Jan 20, 2014
.gitattributes Added gitattributes to stop git complaining about CR/LF Nov 12, 2012
.gitignore Update .gitignore Jul 24, 2015
.jscsrc Updated jscs rules Oct 1, 2015
.jshintignore Add jshint support to Gruntfile and fixed some typo based on jshint spec Dec 4, 2014
.jshintrc Changes necessary for filter by value functionality Mar 2, 2016
.npmignore Update .npmignore file Mar 21, 2016
.travis.yml Set timezone for tests. #3254 Feb 19, 2016
CHANGELOG.md 0.12.0 Nov 27, 2014
CNAME Rename CNAME_ to CNAME May 15, 2013
CONTRIBUTING.md Update contributing text Apr 13, 2015
Gruntfile.js Add missing tests Sep 2, 2016
LICENSE Add better support for npm dependencies and support for injecting LIC… Nov 3, 2015
README.md Update shields in readme Jul 12, 2016
bower.json 0.26.1 Jul 27, 2016
handsontable.jquery.json 0.28.0 Sep 15, 2016
index.html Add new functionality simultaneously manual resizing columns and rows. Apr 5, 2016
package.json 0.28.0 Sep 15, 2016
update.json 0.12.0 Nov 27, 2014


Build Status

Handsontable is a pure JavaScript/HTML5 spreadsheet component with an Excel-like appearance. It can easily integrate with any data source and comes with a variety of useful features like data binding, validation, sorting or powerful custom context menu. Actively supported by the Handsoncode team team and many contributors.

Build status npm npm

What to use it for?

We have seen Handsontable being used in many different, sometimes completely unexpected fields. The list below is just to give you a rough idea on what you can do with Handsontable, but it doesn't limit you in any way.

  • Database editing
  • Configuration controlling
  • Data merging
  • Team scheduling
  • Sales reporting
  • Financial analysis


There are many ways to install Handsontable but we suggest using npm or Bower.

npm install handsontable --save


bower install handsontable --save

Alternative installation

AMD support

If you use a modular script loader then you can require Handsontable just like any other module:

require(['handsontable'], function(Handsontable) {
    var hot = new Handsontable(document.getElementById('example'), {
      data: [[1, 2, 3, 4], [1, 2, 3, 4]]

CommonJS module support

If you use a CommonJS compatible environment you can use the require function to import Handsontable:

var handsontable = require('handsontable');

To bundle Handsontable with Browserify you must specify the module names of all required modules:

browserify main.js -o bundle.js -r moment -r pikaday -r zeroclipboard -r numbro

Basic usage

Assuming you have already installed Handsontable, add an empty <div> element that will be turned into a spreadsheet:

<div id="example"></div>

In the next step, pass a reference to that <div> element and fill it with sample data:

var data = [
  ["", "Ford", "Volvo", "Toyota", "Honda"],
  ["2016", 10, 11, 12, 13],
  ["2017", 20, 11, 14, 13],
  ["2018", 30, 15, 12, 13]

var container = document.getElementById('example');
var hot = new Handsontable(container, {
  data: data,
  rowHeaders: true,
  colHeaders: true



Commercial version

Handsontable Pro is our premium spreadsheet solution packed with business-ready features. It comes with forum support, where you can find the answers to common questions as well as talk directly with our core team members.

Pro Feature Description
Binding rows with headers Bind rows with headers to lock the row number and always display one beside the other.
Collapsing columns Expand and collapse columns to better fit the content.
Column summary Carry out pre-defined calculations and display the results in Handsontable.
Dropdown menu Add a menu to the heading to enable additional operations for the columns.
Export to file Export data to a flat file like CSV or a string.
Filtering Display rows that meet your criteria and hide the rest.
Gantt Chart Create a simple Gantt Chart using Handsontable.
Header tooltips Display the header label in a tooltip.
Hiding columns Hide specific columns and show the rest.
Hiding rows Hide specific rows and show the rest.
Nested headers Create a nested, hierarchical structure of headers to get your data into groups.
Trimming rows Exclude specific rows from the rendering process so they won't be displayed.

Have questions regarding the Pro version? Contact us or take a look at the Frequently Asked Questions.


Handsontable Screenshot



If you would like to help us in writing the code, please take a look into CONTRIBUTING.md

Copyright and license

Handsontable is released under the MIT license.

Copyrights belong to Handsoncode sp. z o.o.