Basic DataTables

Zero Configuration

DataTables has most features enabled by default, so all you need to do to use it with your own tables is to call the construction function:$().DataTable();.Searching, ordering and paging goodness will be immediately added to the table, as shown in this example.
Name Position Office Age Start date Salary Action
Tiger Nixon System Architect Edinburgh 61 2011/04/25 $320,800
Garrett Winters Accountant Tokyo 63 2011/07/25 $170,750
Ashton Cox Junior Technical Author San Francisco 66 2009/01/12 $86,000
Cedric Kelly Senior Javascript Developer Edinburgh 22 2012/03/29 $433,060
Airi Satou Accountant Tokyo 33 2008/11/28 $162,700
Brielle Williamson Integration Specialist New York 61 2012/12/02 $372,000
Herrod Chandler Sales Assistant San Francisco 59 2012/08/06 $137,500
Rhona Davidson Integration Specialist Tokyo 55 2010/10/14 $327,900
Colleen Hurst Javascript Developer San Francisco 39 2009/09/15 $205,500
Sonya Frost Software Engineer Edinburgh 23 2008/12/13 $103,600
Jena Gaines Office Manager London 30 2008/12/19 $90,560
Quinn Flynn Support Lead Edinburgh 22 2013/03/03 $342,000
Charde Marshall Regional Director San Francisco 36 2008/10/16 $470,600
Donna Snider Customer Support New York 27 2011/01/25 $112,000

Complex headers (rowspan and colspan)

When using tables to display data, you will often wish to display column information in groups. DataTables fully supports colspan androwspan in the table's header, assigning the required order listeners to the TH element suitable for that column. Each column must have one TH cell which is unique to it for the listeners to be added. By default DataTables will use the bottom unique cell for the column to attach the order listener, if more than one cell for a column if found. The orderCellsTop:optionoption can be used to tell DataTables to use the top cell if you prefer.The example shown below has two sets of grouped information, grouped by colspan in the header.
Name HR Information Contact
Position Salary Office CV Status E-mail Action
Tiger Nixon System Architect $320,800 Edinburgh hired t.nixon@datatables.net
Garrett Winters Accountant $170,750 Tokyo Pending g.winters@datatables.net
Ashton Cox Junior Technical Author $86,000 San Francisco in process a.cox@datatables.net
Cedric Kelly Senior Javascript Developer $433,060 Edinburgh in process c.kelly@datatables.net
Airi Satou Accountant $162,700 Tokyo hired a.satou@datatables.net
Brielle Williamson Integration Specialist $372,000 New York Pending b.williamson@datatables.net
Herrod Chandler Sales Assistant $137,500 San Francisco in process h.chandler@datatables.net
Rhona Davidson Integration Specialist $327,900 Tokyo hired r.davidson@datatables.net
Colleen Hurst Javascript Developer $205,500 San Francisco Pending c.hurst@datatables.net
Sonya Frost Software Engineer $103,600 Edinburgh in process s.frost@datatables.net
Jena Gaines Office Manager $90,560 London hired j.gaines@datatables.net
Quinn Flynn Support Lead $342,000 Edinburgh in process q.flynn@datatables.net
Charde Marshall Regional Director $470,600 San Francisco in process c.marshall@datatables.net
Haley Kennedy Senior Marketing Designer $313,500 London hired h.kennedy@datatables.net
Tatyana Fitzpatrick Regional Director $385,750 London Pending t.fitzpatrick@datatables.net
Michael Silva Marketing Designer $198,500 London in process m.silva@datatables.net
Paul Byrd Chief Financial Officer (CFO) $725,000 New York in process p.byrd@datatables.net
Gloria Little Systems Administrator $237,500 New York hired g.little@datatables.net
Bradley Greer Software Engineer $132,000 London Pending b.greer@datatables.net
Dai Rios Personnel Lead $217,500 Edinburgh in process d.rios@datatables.net
Jenette Caldwell Development Lead $345,000 New York hired j.caldwell@datatables.net
Yuri Berry Chief Marketing Officer (CMO) $675,000 New York Pending y.berry@datatables.net
Caesar Vance Pre-Sales Support $106,450 New York in process c.vance@datatables.net
Doris Wilder Sales Assistant $85,600 Sidney hired d.wilder@datatables.net
Angelica Ramos Chief Executive Officer (CEO) $1,200,000 London Pending a.ramos@datatables.net
Gavin Joyce Developer $92,575 Edinburgh in process g.joyce@datatables.net
Jennifer Chang Regional Director $357,650 Singapore hired j.chang@datatables.net
Brenden Wagner Software Engineer $206,850 San Francisco hired b.wagner@datatables.net
Fiona Green Chief Operating Officer (COO) $850,000 San Francisco Pending f.green@datatables.net
Shou Itou Regional Marketing $163,000 Tokyo in process s.itou@datatables.net
Michelle House Integration Specialist $95,400 Sidney hired m.house@datatables.net
Suki Burks Developer $114,500 London Pending s.burks@datatables.net
Prescott Bartlett Technical Author $145,000 London in process p.bartlett@datatables.net
Gavin Cortez Team Leader $235,500 San Francisco hired g.cortez@datatables.net
Martena Mccray Post-Sales support $324,050 Edinburgh hired m.mccray@datatables.net
Unity Butler Marketing Designer $85,675 San Francisco Pending u.butler@datatables.net
Howard Hatfield Office Manager $164,500 San Francisco in process h.hatfield@datatables.net
Hope Fuentes Secretary $109,850 San Francisco hired h.fuentes@datatables.net
Vivian Harrell Financial Controller $452,500 San Francisco Pending v.harrell@datatables.net
Timothy Mooney Office Manager $136,200 London in process t.mooney@datatables.net
Jackson Bradshaw Director $645,750 New York hired j.bradshaw@datatables.net
Olivia Liang Support Engineer $234,500 Singapore Pending o.liang@datatables.net
Bruno Nash Software Engineer $163,500 London in process b.nash@datatables.net
Sakura Yamamoto Support Engineer $139,575 Tokyo Pending s.yamamoto@datatables.net
Thor Walton Developer $98,540 New York in process t.walton@datatables.net
Finn Camacho Support Engineer $87,500 San Francisco hired f.camacho@datatables.net
Serge Baldwin Data Coordinator $138,575 Singapore Pending s.baldwin@datatables.net
Zenaida Frank Software Engineer $125,250 New York in process z.frank@datatables.net
Zorita Serrano Software Engineer $115,000 San Francisco hired z.serrano@datatables.net
Jennifer Acosta Junior Javascript Developer $75,650 Edinburgh Pending j.acosta@datatables.net
Cara Stevens Sales Assistant $145,600 New York in process c.stevens@datatables.net
Hermione Butler Regional Director $356,250 London hired h.butler@datatables.net
Lael Greer Systems Administrator $103,500 London Pending l.greer@datatables.net
Jonas Alexander Developer $86,500 San Francisco in process j.alexander@datatables.net
Shad Decker Regional Director $183,000 Edinburgh hired s.decker@datatables.net
Michael Bruce Javascript Developer $183,000 Singapore hired m.bruce@datatables.net
Donna Snider Customer Support $112,000 New York hired d.snider@datatables.net
Name Position Salary Office CV Status E-mail Action

State saving

DataTables has the option of being able to save the state of a table (its paging position, ordering state etc) so that is can be restored when the user reloads a page, or comes back to the page after visiting a sub-page. This state saving ability is enabled by the stateSave option.The built in state saving method uses the HTML5 localStorage and sessionStorage APIs for efficient storage of the data. Please note that this means that the built in state saving option will not work with IE6/7 as these browsers do not support these APIs. Alternative options of using cookies or saving the state on the server through Ajax can be used through the stateSaveCallback and stateLoadCallback options.The duration for which the saved state is valid and can be used to restore the table state can be set using the stateDuration initialisation parameter (2 hours by default). This parameter also controls if localStorage (0 or greater) or sessionStorage (-1) is used to store the data.The example below simply shows state saving enabled in DataTables with the stateSave option.
Name Position Office Age Start date Salary Action
Tiger Nixon System Architect Edinburgh 61 2011/04/25 $320,800
Garrett Winters Accountant Tokyo 63 2011/07/25 $170,750
Ashton Cox Junior Technical Author San Francisco 66 2009/01/12 $86,000
Cedric Kelly Senior Javascript Developer Edinburgh 22 2012/03/29 $433,060
Airi Satou Accountant Tokyo 33 2008/11/28 $162,700
Brielle Williamson Integration Specialist New York 61 2012/12/02 $372,000
Herrod Chandler Sales Assistant San Francisco 59 2012/08/06 $137,500
Rhona Davidson Integration Specialist Tokyo 55 2010/10/14 $327,900
Colleen Hurst Javascript Developer San Francisco 39 2009/09/15 $205,500
Sonya Frost Software Engineer Edinburgh 23 2008/12/13 $103,600
Jena Gaines Office Manager London 30 2008/12/19 $90,560
Quinn Flynn Support Lead Edinburgh 22 2013/03/03 $342,000
Charde Marshall Regional Director San Francisco 36 2008/10/16 $470,600
Haley Kennedy Senior Marketing Designer London 43 2012/12/18 $313,500
Tatyana Fitzpatrick Regional Director London 19 2010/03/17 $385,750
Michael Silva Marketing Designer London 66 2012/11/27 $198,500
Paul Byrd Chief Financial Officer (CFO) New York 64 2010/06/09 $725,000
Gloria Little Systems Administrator New York 59 2009/04/10 $237,500
Bradley Greer Software Engineer London 41 2012/10/13 $132,000
Dai Rios Personnel Lead Edinburgh 35 2012/09/26 $217,500
Jenette Caldwell Development Lead New York 30 2011/09/03 $345,000
Yuri Berry Chief Marketing Officer (CMO) New York 40 2009/06/25 $675,000
Caesar Vance Pre-Sales Support New York 21 2011/12/12 $106,450
Doris Wilder Sales Assistant Sidney 23 2010/09/20 $85,600
Angelica Ramos Chief Executive Officer (CEO) London 47 2009/10/09 $1,200,000
Gavin Joyce Developer Edinburgh 42 2010/12/22 $92,575
Jennifer Chang Regional Director Singapore 28 2010/11/14 $357,650
Brenden Wagner Software Engineer San Francisco 28 2011/06/07 $206,850
Fiona Green Chief Operating Officer (COO) San Francisco 48 2010/03/11 $850,000
Shou Itou Regional Marketing Tokyo 20 2011/08/14 $163,000
Michelle House Integration Specialist Sidney 37 2011/06/02 $95,400
Suki Burks Developer London 53 2009/10/22 $114,500
Prescott Bartlett Technical Author London 27 2011/05/07 $145,000
Gavin Cortez Team Leader San Francisco 22 2008/10/26 $235,500
Martena Mccray Post-Sales support Edinburgh 46 2011/03/09 $324,050
Unity Butler Marketing Designer San Francisco 47 2009/12/09 $85,675
Howard Hatfield Office Manager San Francisco 51 2008/12/16 $164,500
Hope Fuentes Secretary San Francisco 41 2010/02/12 $109,850
Vivian Harrell Financial Controller San Francisco 62 2009/02/14 $452,500
Timothy Mooney Office Manager London 37 2008/12/11 $136,200
Jackson Bradshaw Director New York 65 2008/09/26 $645,750
Olivia Liang Support Engineer Singapore 64 2011/02/03 $234,500
Bruno Nash Software Engineer London 38 2011/05/03 $163,500
Sakura Yamamoto Support Engineer Tokyo 37 2009/08/19 $139,575
Thor Walton Developer New York 61 2013/08/11 $98,540
Finn Camacho Support Engineer San Francisco 47 2009/07/07 $87,500
Serge Baldwin Data Coordinator Singapore 64 2012/04/09 $138,575
Zenaida Frank Software Engineer New York 63 2010/01/04 $125,250
Zorita Serrano Software Engineer San Francisco 56 2012/06/01 $115,000
Jennifer Acosta Junior Javascript Developer Edinburgh 43 2013/02/01 $75,650
Cara Stevens Sales Assistant New York 46 2011/12/06 $145,600
Hermione Butler Regional Director London 47 2011/03/21 $356,250
Lael Greer Systems Administrator London 21 2009/02/27 $103,500
Jonas Alexander Developer San Francisco 30 2010/07/14 $86,500
Shad Decker Regional Director Edinburgh 51 2008/11/13 $183,000
Michael Bruce Javascript Developer Singapore 29 2011/06/27 $183,000
Donna Snider Customer Support New York 27 2011/01/25 $112,000
Name Position Office Age Start date Salary Action

Scroll - vertical, dynamic height

This example shows a vertically scrolling DataTable that makes use of the CSS3 vh unit in order to dynamically resize the viewport based on the browser window height. The vh unit is effectively a percentage of the browser window height. So the 50vh used in this example is 50% of the window height. The viewport size will update dynamically as the window is resized.A relatively modern browser is required for vh units to operate correctly. IE9+ supports the vh unit and all other evergreen browsers.
Name Position Office Age Start date Salary Action
Tiger Nixon System Architect Edinburgh 61 2011/04/25 $320,800
Garrett Winters Accountant Tokyo 63 2011/07/25 $170,750
Ashton Cox Junior Technical Author San Francisco 66 2009/01/12 $86,000
Cedric Kelly Senior Javascript Developer Edinburgh 22 2012/03/29 $433,060
Airi Satou Accountant Tokyo 33 2008/11/28 $162,700
Brielle Williamson Integration Specialist New York 61 2012/12/02 $372,000
Herrod Chandler Sales Assistant San Francisco 59 2012/08/06 $137,500
Rhona Davidson Integration Specialist Tokyo 55 2010/10/14 $327,900
Colleen Hurst Javascript Developer San Francisco 39 2009/09/15 $205,500
Sonya Frost Software Engineer Edinburgh 23 2008/12/13 $103,600
Jena Gaines Office Manager London 30 2008/12/19 $90,560
Quinn Flynn Support Lead Edinburgh 22 2013/03/03 $342,000
Charde Marshall Regional Director San Francisco 36 2008/10/16 $470,600
Haley Kennedy Senior Marketing Designer London 43 2012/12/18 $313,500
Tatyana Fitzpatrick Regional Director London 19 2010/03/17 $385,750
Michael Silva Marketing Designer London 66 2012/11/27 $198,500
Paul Byrd Chief Financial Officer (CFO) New York 64 2010/06/09 $725,000
Gloria Little Systems Administrator New York 59 2009/04/10 $237,500
Bradley Greer Software Engineer London 41 2012/10/13 $132,000
Dai Rios Personnel Lead Edinburgh 35 2012/09/26 $217,500
Jenette Caldwell Development Lead New York 30 2011/09/03 $345,000
Yuri Berry Chief Marketing Officer (CMO) New York 40 2009/06/25 $675,000
Caesar Vance Pre-Sales Support New York 21 2011/12/12 $106,450
Doris Wilder Sales Assistant Sidney 23 2010/09/20 $85,600
Angelica Ramos Chief Executive Officer (CEO) London 47 2009/10/09 $1,200,000
Gavin Joyce Developer Edinburgh 42 2010/12/22 $92,575
Jennifer Chang Regional Director Singapore 28 2010/11/14 $357,650
Brenden Wagner Software Engineer San Francisco 28 2011/06/07 $206,850
Fiona Green Chief Operating Officer (COO) San Francisco 48 2010/03/11 $850,000
Shou Itou Regional Marketing Tokyo 20 2011/08/14 $163,000
Michelle House Integration Specialist Sidney 37 2011/06/02 $95,400
Suki Burks Developer London 53 2009/10/22 $114,500
Prescott Bartlett Technical Author London 27 2011/05/07 $145,000
Gavin Cortez Team Leader San Francisco 22 2008/10/26 $235,500
Martena Mccray Post-Sales support Edinburgh 46 2011/03/09 $324,050
Unity Butler Marketing Designer San Francisco 47 2009/12/09 $85,675
Howard Hatfield Office Manager San Francisco 51 2008/12/16 $164,500
Hope Fuentes Secretary San Francisco 41 2010/02/12 $109,850
Vivian Harrell Financial Controller San Francisco 62 2009/02/14 $452,500
Timothy Mooney Office Manager London 37 2008/12/11 $136,200
Jackson Bradshaw Director New York 65 2008/09/26 $645,750
Olivia Liang Support Engineer Singapore 64 2011/02/03 $234,500
Bruno Nash Software Engineer London 38 2011/05/03 $163,500
Sakura Yamamoto Support Engineer Tokyo 37 2009/08/19 $139,575
Thor Walton Developer New York 61 2013/08/11 $98,540
Finn Camacho Support Engineer San Francisco 47 2009/07/07 $87,500
Serge Baldwin Data Coordinator Singapore 64 2012/04/09 $138,575
Zenaida Frank Software Engineer New York 63 2010/01/04 $125,250
Zorita Serrano Software Engineer San Francisco 56 2012/06/01 $115,000
Jennifer Acosta Junior Javascript Developer Edinburgh 43 2013/02/01 $75,650
Cara Stevens Sales Assistant New York 46 2011/12/06 $145,600
Hermione Butler Regional Director London 47 2011/03/21 $356,250
Lael Greer Systems Administrator London 21 2009/02/27 $103,500
Jonas Alexander Developer San Francisco 30 2010/07/14 $86,500
Shad Decker Regional Director Edinburgh 51 2008/11/13 $183,000
Michael Bruce Javascript Developer Singapore 29 2011/06/27 $183,000
Donna Snider Customer Support New York 27 2011/01/25 $112,000
Name Position Office Age Start date Salary