For a high level overview of DataTables 3, please see the following documentation:

• Announcement blog post
• New features
• Upgrade notes

Since the 3.0.0-beta.2 release there have been a number of changes and few new features, which are detailed below.

For a full description of the changes in this major release since the last non-beta release, please refer to the release notes for the two betas:

• DataTables 3.0.0-beta.2
• DataTables 3.0.0-beta.1

New

• DataTable.key() which is used to register a license key for use with DataTables Plus extensions (e.g. Editor and CardView).
• Row invalidation event which can be used by extensions to tell when a row's data has been updated.
• When a page length is specified that isn't in the dropdown list (pageLength), a temporary option for that value will be added so it is less confusing for the end user.
• DataTable.Dom.s(document).on('ready'...) event. This is provided as a convenience rather than needing to listen for DOMContentLoaded and take account of if the document has already loaded or not.

Fixes

• When the datetime renderer was used for the first time, it would override any class already set for that rendering type.
• Improved performance when appending a large number of DOM elements and a DOM mutation observer is used.
• Table initialisation would not complete if state saving with named columns and the ordering column changed.
• data-dt-row and data-dt-column selectors weren't working correctly
• Delegated event removal without jQuery
• Cancel Ajax when beforeSend returns false
• Fix vanilla delegated blur handling
• columns().widths() didn't correctly take into account Responsive hidden columns
• If data is provided as a string for DataTable.ajax it wasn't submitting
• Adding autocomplete=off attributes to table input controls to improve accessability
• Events added by on are now automatically removed if a table is destroyed
• Caption position wasn't correct when used with scrolling features
• Empty footer is no longer in the DOM, so the CSS to hide an empty footer is redundant and can be removed.

Docs

• dom, pagingType and orderCellsTop where marked for removal in v3, but they are too widely used to remove at the moment. Only dom takes much code (and even then, not much) but it would be the most disruptive. Removing them from v3 deprecation target.

Download DataTables 3.0.0

There have been no functional changes in the software since its beta release. For a full description of the changes in this major release since the last non-beta release, please refer to the beta's release notes:

• Select 4.0.0-beta.1

• No code changes since 4.0.0-beta.1

Download Select 4.0.0

There is just one fix in this release compared to the previous beta of this software (see details below).

For a full description of the changes in this major release since the last non-beta release, please refer to the beta's release notes:

• SearchBuilder 2.0.0-beta.1

Fixes

• Correct Typescript API parameters for SearchBuilder methods

Download SearchBuilder 2.0.0

There have been no functional changes in the software since the beta release. For a full description of the changes in this major release since the last non-beta release, please refer to the beta's release notes:

• Scroller 3.0.0-beta.1

• No code changes since 3.0.0-beta.1

Download Scroller 3.0.0

There is just one fix in this release compared to the previous beta of this software (see details below).

For a full description of the changes in this major release since the last non-beta release, please refer to the beta's release notes:

• RowReorder 2.0.0-beta.1

Fixes

• Once reordered, need to explicitly get the rows in document order

Download RowReorder 2.0.0

There have been no functional changes in the software since the beta release. For a full description of the changes in this major release since the last non-beta release, please refer to the beta's release notes:

• RowGroup 2.0.0-beta.1

• No code changes since 2.0.0-beta.1

Download RowGroup 2.0.0

There has been just a single new addition since the previous beta, which is to have the display view automatically update if the host row's data is invalidated in the main table.

For a full description of the changes in this major release since the last non-beta release, please refer to the beta's release notes:

• Responsive 4.0.0-beta.1

• When a row's data is invalidated in DataTables core, its details display is now automatically udpated.

Download Responsive 4.0.0

There have been no functional changes in the software since the beta release. For a full description of the changes in this major release since the last non-beta release, please refer to the beta's release notes:

• KeyTable 3.0.0-beta.1

• No changes since 3.0.0-beta.1

Download KeyTable 3.0.0

There have been no functional changes in the software since the beta release. For a full description of the changes in this major release since the last non-beta release, please refer to the beta's release notes:

• FixedHeader 5.0.0-beta.1

• No changes since 5.0.0-beta.1

Download FixedHeader 5.0.0

There have been no functional changes in the software since the beta release. For a full description of the changes in this major release since the last non-beta release, please refer to the beta's release notes:

• FixedColumns 6.0.0-beta.1

• No changes since 6.0.0-beta.1

Download FixedColumns 6.0.0

Moveover, Editor is now available on the DataTables CDN and the public NPM repository!

Editor is now part of the DataTables Plus suite of extensions and requires a license key to use. If you have an existing Editor license, your license key is available on your DataTables account page.

Further details on updating to Editor 3 are available in this upgrades notes document, which also highlights the major new features.

The release notes below document the specific changes.

Core

New

• Editor is part of the DataTables Plus suite of extensions
• static display controller which can be used to display the Editor form in a pre-defined element. This is primarily designed for use with a form that is always visible (i.e. standalone page editing).
• dataSrc option which can be used to tell Editor where to get the data to edit from. Specifically in addition to the HTML and DataTable sources that it could proviously do, this option can now be explicity set to ajax to have the form read remote data without needing a source DataTable.
• ajax.replacements will now apply to the Ajax calls made by upload and uploadMany.
• on option which can be used to assign event handlers during initialisation. This matches DataTables' own on option.
• template can now be given a template as the element to use as the template. In this case the contents are cloned and used as the form template. If any other element type is used, the original method of detaching the element and using it directly is still used.
• Support for HTML5 validation attributes. Use the attr parameter for fields to set the validation conditions and the new fields.errorText option to set the error message. The error state is only triggered when the form is submitted. Server-side validation is uneffected.
• The ajax option for autocomplete and tags can now be given as an object to provide fine-grained control over the Ajax request.

Updated

• Fields which are in an error state now have a box-shadow to highlight them (DataTables default styling).
• display can now be given as a CSS selector string, which will result in static being used with the given selector used to pick the element that the form will be displayed in. This is just an easy shorthand for static.
• Editor buttons (when using DataTables styling) updated to match the styling of DataTables' and Button's styling in v3.
• fields() undeprecated. It is tiny and can still be useful. No intention to remove it, so will keep it in place.
• ES6 output target from TypeScript

Fixes

• ajax.replacements can now have a value set to false, and as a special case, id if specified will cause the default _id_ / {id} replacement not to happen (i.e. you can now specify your own replacement, or cancel the default action).
• It was possible for a close event to be triggered after an instance was destroyed. No longer.
• Only attempt to replace _id_ if id has a value.
• Text input alignment should inherit for inline editing
• Upload button should have a cursor icon
• When uploadMany is disabled, upload and remove buttons should be removed
• When using nested editing with the styling frameworks (e.g. Bootstrap), the form title separator wasn't being displayed.

Docs

• Consistent naming for DataTables types
• Correct naming
• Updated for the more consistent naming convention used for DataTables' defined types in DT3
• Update event parameter naming to match API
• Update for non-jQuery events

Examples

• Update French translation examples to latest CDN data
• Add static display controller example
• New examples showing CardView being used with Editor
• Remove jQuery dependencies from examples

.NET

New

• DataTable class to enable reading of data from a database table without needing to use the Editor class (which is the read / write equivalent).
• Editor.Fields() and DataTable.Columns() methods for adding multiple columns with an array (IEnumerable more specifically)
• Method for removing duplicate dictionaries based on all key/value pairs, and called this before returning the output when manual entries were added to the options list.

Updates

• Editor.Field() with an array is now deprecated

Fixes

• Change the default data provider for SQLServer to be Microsoft.Data.SqlClient, updated from System.Data.SqlClient.
• Deleting a row from a table which uses an alias for the table name would cause the row to not be deleted, and no errors or messages raised. It is now correctly deleted.
• Fixed label and value assignment for manual options
• SearchPanes support - empty data can mean null or empty string on the client-side. Previously the server-side used only null. Now both.
• Perform a null check before going to the database, and return an empty list if are null (and would generate an exception)

Removed

• Build for .NET Framework 4.5, 4.6 and 4.7. 4.8 is still supported

Node.js

New

• DataTable class to enable reading of data from a database table without needing to use the Editor class (which is the read / write equivalent).
• Full ESM support. This library is now built for both CJS and ESM environments, with Node automatically selected which build to use through the exports option in package.json.

Updated

• Use native promise file system methods, rather than wrapping the sync ones.

Fixes

• Improved Typescript typing
• SearchPanes support - empty data can mean null or empty string on the client-side. Previously the server-side used only null. Now both.

PHP

New

• DataTable class to enable reading of data from a database table without needing to use the Editor class (which is the read / write equivalent).

Fixes

• Only include the config.php file if it is present
• SearchPanes support - empty data can mean null or empty string on the client-side. Previously the server-side used only null. Now both.

Python

New Python port of the libraries for DataTables, providing full support for Editor.

Download Editor 3.0.0

There is just one change since the v2 beta release, which is noted below.

For a full description of the changes in this major release since the last non-beta release, please refer to the beta's release notes:

• DateTime 2.0.0-beta.1

Fixes

• Address memory leak when destroying an instance

Download DateTime 2.0.0

There have been a couple of new features and bug fixes made in this release, since the previous beta, including a new info content type. Please refer to the specifics below.

For a full description of the changes in this major release since the last non-beta release, please refer to the beta's release notes:

• ColumnControl 2.0.0-beta.1

New

• State saving supports named columns now, allowing columns to be added and removed while still saving state of other columns (as long as they are named).
• info content type which will show a tooltip providing extra information about a column without clutter the screen.

Fixes

• If a date column type changes, ColumnControl will now update for the new type
• When using state saving and date columns, a formatted date would not be correctly resolved
• When DataTable.render.date() was used without moment or luxon on the page, date picker search would not work.
• When setting value of a list button, perform clearing of active state as well as setting it

Download ColumnControl 2.0.0

There have been no functional changes in ColReorder since the 3.0.0-beta.1 release. For a full description of the changes in this major release since the last non-beta release, please refer to the beta's release notes:

• ColReorder 3.0.0-beta.1

• No code changes since 3.0.0-beta.1

Download ColReorder 3.0.0

New

• Option to display row entries as cards
• Custom templates can be used for full layout control
• Dynamic page fitting
• Automatic (and adjustable) layout fitting
• Dynamic responsive display for tables
• User definable display through buttons or API calls.

Download CardView 1.0.0

There are a number of reasons for doing this:

• The additional files are really awkward in npm / node
• Has caused plenty of confusion in the past about needing those files
• Makes the download builder simpler

This is a backwards compatible change - the original files are now no-op files and can be included with no ill effect. They shouldn't be included for new projects, but old projects can continue to use them with no issues and they can be dropped as developer time allows.

For a full description of the changes in this major release since the last non-beta release, please refer also to the previous release notes:

• Buttons 4.0.0-beta.1

New

• The buttons that were previously split out into separate files (HTML5, ColVis and Print) are now integrated into Buttons core.
• orderCol and columnOrder button types to provide control over the table ordering via buttons.

Updates

• ES6 output target from TypeScript

Fixes

• Default styling - when buttons flow on to a second line, there should be a small gap between the button rows.
• Export to Excel should only convert numerically typed columns to number data types in Excel.
• Button alignment issues in Bulma, Foundation and Fomantic
• Correct alignment error when used with other components on the same line of a DT layout

Download Buttons 4.0.0

• AutoFill 3.0.0-beta.1

• Fix: Address memory leaks when enabling autofill
• Update: ES6 output target from TypeScript

Download AutoFill 3.0.0

New

• Improved timezone support for date and time renderers - time zone is not shifted when displaying a date / time (i.e. the displayed timezone matches the input).
• Accessability for scrolling tables. Roles are assigned allowing screenreaders such as NVDA to see a scrolling table as a single table

Fixes

• If the table holds no data for the page when being drawn and paging is held (i.e. the rows have been deleted), then the paging will "rewind" to the previous page now.
• Adding Dom.prototype.sort() method to allow an external request to reorder elements in document order (required for RowReorder).
• Types - correct the Api interface name in the build file
• Correct callback function types for the initialisation object
• Don't mix UTC and timezone processing. It results in offsets where they aren't wanted.
• CSS variable for vertical align in the header wasn't applied correctly
• Dark mode for page length <select>
• Keyboard tabbing will no longer land on hidden elements in a scrolling table
• Correction to background for processing indicator

Download DataTables 3.0.0-beta.2

Fixes

• If the table holds no data for the page when being drawn and paging is held (i.e. the rows have been deleted), then the paging will "rewind" to the previous page now.
• Improved timezone support for date and time renderers - time zone is not shifted when displaying a date / time (i.e. the displayed timezone matches the input).
• Don't mix UTC and timezone processing. It results in offsets where they aren't wanted.
• Keyboard tabbing will no longer land on hidden elements in a scrolling table
• Multi-line html elements could still cause issues for column sizing
• XHTML fix for when scrolling is enabled
• Accessability - remove the -tag tfoot element if it is empty
• Don't include <template> or `` tags in the sizing table
• jQuery UI styling when used with FixedHeader - the header would have slightly different styling when floating (bold and decreased padding)

Download DataTables 2.3.8