Licensing
Most of ApexCharts needs no license key. A key does one thing: it removes the trial watermark from the premium features and chart types listed below. Every other chart type and option renders the same with or without one. Which license your organization needs is a separate question, answered by the license terms and pricing.
What needs a license key
The premium features and chart types below need a key on the Premium or OEM plan. A Pro key does not remove their watermark.
Without a valid key they still work in full, with an "APEXCHARTS" watermark on the chart, so you can evaluate them in your own app with your own data. The watermark appears only on charts that use one of them.
The premium features are also opt-in imports. The key licenses a feature, it does not load it, so each feature's page shows the import it needs.
Setting the key
Call ApexCharts.setLicense() once, before you create any chart. One call covers every chart on the page.
import ApexCharts from 'apexcharts'
ApexCharts.setLicense('APEX-xxxxxxxx')
In React, Vue and Angular the wrappers render with the apexcharts package, so make the same call on the apexcharts import, at module level in the file that sets up your charts. With the CDN build, call window.ApexCharts.setLicense() after the script tag.
A key set after charts have rendered clears their watermark without a reload. To license a single chart instead, pass the key as chart.license, which takes precedence over the page key for that chart.
The same call also licenses the current releases of the other Apex libraries on the page, so a page that mixes charts with ApexTree, ApexSankey, ApexGantt, ApexMaps or ApexStock needs one key and one call.
How the key is validated
The key is checked in the browser, by the library itself. There is no activation step, no license server and nothing to run on your backend, and the check makes no network request.
- The key is meant to ship in client-side code. It holds your plan, issue date and expiry date, with a digital signature over them. A key whose contents have been changed fails the check.
- It works offline. Intranets and installations with no internet access are supported, because nothing is fetched.
- It works on any hostname. Keys are not tied to a domain, so the same key works on every deployment of your application. If you need a key restricted to your own hostnames, contact support.
Expiry and renewal
A key is valid until the end of the subscription period it was issued for. After that date the premium features show the watermark again. Nothing else changes, and charts that use none of them are unaffected.
When your subscription renews, a new key is issued. It is emailed to you and shown on your account page. Replace the old key with it. Developers you list under Developer Details on that page are invited to your key and receive every new one as well.
If you ship an application that your customers host themselves, load the key from runtime configuration rather than compiling it into your bundle. A renewal is then a configuration change for each installation rather than a new release of your product.
See the renewal terms, and for redistribution, the OEM license.
Versions before 6.5.0
ApexCharts checks license keys from version 6.5.0. Earlier releases contain no key check, so there is no key to set and no watermark. The license terms apply to every version.