25. DataTables Plus
DataTables Plus provides a number of additional premium extensions, including Editor, CardView and StateRestore. Use of these extensions requires a license key, which is registered with your DataTables install.
Meaning
If you get a message displayed in a yellow box at the bottom right of your page with the following structure:
DataTables Plus: {information} - learn more
It means that the DataTables suite software being used is not licensed or that the trial period for the software has expired. The {information} string will be one of:
- License key required
- License key invalid
- Trial expired
- Upgrade required for this version
- License for Editor only. Upgrade for Plus
The following explains in more detail what each message means and how to resolve it.
License key required
This message means that you are using an extension that requires a DataTables Plus license, but have not registered a license key with DataTables.
If you have already purchased a license key, use DataTable.key() to register your key before you initialise any DataTables on your page. Your license key can be found on your account page. For example:
// Load DataTables
import 'datatables.net-dt';
// Register key
DataTable.key('plus_20270101:jd2m3FxB4BRQ5pqw...');
// Initialise DataTables
new DataTable('#myTable');
If you have not yet purchased a DataTables Plus license, you can can do so on the purchase page, or start a trial on the download page.
License key invalid
If the message states that the license key is invalid, it means that the key provided using DataTable.key() is not recognised as a valid DataTables license key. Possibly this is due to an incomplete copy / paste action, or some other form of data corruption.
To resolve, go to your your account page and copy the complete license key (it is just over 100 characters long).
Trial expired
If you have been using a trial key for DataTables Plus, this message will pop up when the key expires. In the days before this happens, console messages will be written to your browser to keep you informed of when the trial will expire. Trial keys are identified by starting with trial_ and then the date that the key will expire.
To address this, you need to replace the key with a valid license key, or remove the DataTables Plus features that you are using. You can purchase a license key here.
Upgrade required for this version
When you purchase a license for DataTables Plus, you can use all versions of the Plus extensions that are released for a year after the purchase date, and you can continue to use them indefinitely. However, if you update to a version that is released after that period of time, this message will appear.
To resolve, you can either purchase an update key or return to a version that was released within the support time frame for your previous purchase.
License for Editor only. Upgrade for Plus
If this message it shown, it means that a license key for Editor was provided to the software, but another part of the DataTables Plus suite is being used on your site / app.
You will be able to identify an Editor specific license key as it starts with editor_, whereas a DataTables Plus key (which includes an Editor license), starts with plus_.
To remove this message, upgrade your Editor license key to a DataTables Plus key, which you can do here.