Web SDK gets regular updates with new features, bug fixes, and performance improvements. We use version numbers to reflect those changes. To assign and increment those version numbers, we follow Semantic Versioning.
This page describes what you should expect in terms of versions availability and updates.
We distribute the different versions of Web SDK through different URLs in our CDN. You can load the latest major, minor, and bug fix versions.
For example, assuming that the
v1.0.0 version is the latest released version, you can load it using any of the following URLs:
New versions usually bring new features, bug fixes, and performance improvements, so you might be thinking you should always use the latest available major version. It depends. If your application is already performing well and you don’t plan to change it, it’s OK to use a fixed version,
v1.0.0 for instance. If you want to benefit from latest bug fixes, you could go with the
If you don’t use a fixed version, when we release a new version, it could affect your application. This could occur because your application is relying on undocumented or deprecated features, or because of a bug or bug fix we have introduced.
As a workaround, you can use an older version by using a fixed version. See the previous point.
In case you were relying on undocumented or deprecated features, you should consider that workaround a temporal measurement. You should also update your application, so it no longer uses them.
Although we tend to do a release every few weeks of work, we don’t have a fixed schedule for new Web SDK releases. However, if we planned to release a specific feature, we might delay a release. Also, in the case of critical regressions, we will make a bug fix release before the next major/minor release happens.
In case you need to use a new feature before it is released, you can always build your own custom Web SDK bundle.
In any given moment, the last three released major/minor versions are available. For example, if
v1.2.0 were the last released version, we will support:
v1.1.1if for any reason we released a bug fix version of the
For debugging, use the
carto.version property to obtain the current version of Web SDK in your application.