Last modified September 17, 2024 by Shelly Wolfe

Web SDK upgrade guide

This guide provides information about how you can upgrade to the latest Swrve Web SDK. For information about the changes that have been made in each Web SDK release, see the Web SDK release notes.

Upgrading via NPM

If you’re upgrading via NPM, update your package .json dependency @swrve/web-sdk to the latest version of npm i @swrve/web-sdk.


Version 2.3.0

There are no code changes required to upgrade to Swrve Web SDK v2.3.0.


Version 2.2.1

There are no code changes required to upgrade to Swrve Web SDK v2.2.1.


Version 2.2.0

There are no code changes required to upgrade to Swrve Web SDK v2.2.0.


Version 2.1.0

There are no code changes required to upgrade to Swrve Web SDK v2.1.0.


Version 2.0.2

There are no code changes required to upgrade to Swrve Web SDK v2.0.2.


Version 2.0.1

There are no code changes required to upgrade to Swrve Web SDK v2.0.1.


Version 2.0.0

There are several code changes and improvements added to Swrve Web SDK v2.0.0.

The following table lists the methods and fields that have changed or been moved.

Removed Summary
getQueuedEvents Removed to align with other Swrve SDKs.
Moved or changed Summary
createInstance This was formerly the way to start up the SDK but it now only creates an instance. It also no longer initializes the SDK. Use initWithConfig instead.
OnSwrveLoadedCallback This callback was added to initWithConfig as an optional argument. It also no longer has an error message in its response. If something goes through, an exception is now thrown, which can be caught.
It goes in after config. For example: initWithConfig({appId: <your_id>, apiKey: <your_key>, externalUserId: <your_ex_user_id>}, ()=>{ console.log("optional callback")});
namedEvent Renamed to event
purchaseEvent Renamed to purchase
iapEvent Renamed to iap

Changes to initialization

The public method createInstance is still available for use but does not initialize the SDK. This means the SDK no longer starts from createInstance. If you want to have the same functionality as createInstance, please use initWithConfig.


Previous versions

If you are upgrading from a version older than 2.0.0, please refer to the Web SDK integration guide.