Upgrade release notes
Upgrading libraries can often be a painful experience, but it is a key goal of DataTables to not fall into that trap, allowing you to update DataTables cleanly and easily. Backwards compatibility is always a key goal. In order to keep moving forwards, there are sometimes a few changes that might cause issues, depending upon your DataTables configuration. These changes are documented here for each major release of DataTables.
Major releases
Upgrading to DataTables 2 from 1.10+
DataTables 2 is a major release with a lot of changes, enhancements and improvements over the 1.x series. There have also been some items which have been removed or updated and they are highlighted in this document.
It is part of a number of related documents detailing the release of DataTables 2:
Backwards compatibility for a library such as DataTables is very important, so a lot of work has been invested in making sure that as few as possible breaking changes have been made for v2, but there have been some, as detailed on this page. Read more »
Upgrading to DataTables 2.1 from 2.0
As always with a DataTables release, particularly a minor one, there is a strong focus on backwards compatibility. For the most part you should be able to upgrade with 2.1 with no modifications required, however, there are two specific points that it is worth being aware of, as detailed in this document.
This document is part of a number of related documents detailing the release of DataTables 2.1:
Read more »Upgrading to DataTables 1.10 from 1.9
DataTables 1.10 is a significant update to DataTables, including an entirely new API and allowing initialisation option to be specified using camelCase notation, rather than the old style Hungarian notation. Backwards compatibility is an important aspect of 1.10, as always, but there are a few key points that you should be aware of, noted in this document.
Related documents:
Read more »Upgrading to DataTables 1.9 from 1.8
Although DataTables 1.9 has seen a major amount of work on the internal method and structure of the program as a whole, one of the primary goals has been to ensure backwards compatibility is retained. There are only two minor changes that are not 100% backwards compatible, one requiring a little CSS to rectify and the other is state saving customisation. Read more »
Upgrading to DataTables 1.8 from 1.7
DataTables 1.8 has been developed with backwards compatibility in mind and as such it should be a drop in replacement for the majority of developers. With that in mind, there are a few small issues which you should be aware of, particularly if developing plug-ins. Read more »
Upgrading to DataTables 1.7 from 1.6
As with other releases in the 1.x series of DataTables, the 1.7 release focuses on building on what has gone before, without breaking backwards compatibility. Having said that there are a few differences which must be taken into account. Read more »
Upgrading to DataTables 1.6 from 1.5
For the most part, DataTables 1.6 is a drop in replacement for DataTables 1.5. However, there are a number of minor points to be aware of. Read more »