Skip to main content

Web SDK release notes

Swrve has an open source SDK repository.Β There are two options for downloading the latest public Swrve Web SDK:

  • Install the SDK using npm (node package manager). Run the following command:Β npm install @swrve/web-sdk.
  • Download the SDK from theΒ GitHub public repository.

For upgrade instructions, see the Web SDK upgrade guide.


Release 3.0.0​

Release date: TBD

Features​

  • Added in-app message support to the Web SDK. In-app messages now render in the browser and support static and dynamic images, animated GIFs, single-line and multiline text, image, text, and themed buttons, multipage messages, Story messages with timed progression, and MP4 video. Portrait and landscape formats are both supported, and messages scale to fit the browser viewport. For more information, see the Integration guide and Intro to in-app messages.
  • Added a single messageListener callback to inAppMessageConfig for all in-app message interactions. The listener receives the action (impression, custom, or dismiss), a messageDetails object describing the campaign, and a selectedButton object describing the button the user selected. For more information, see the Integration guide.
  • Added Push Inbox support with the pushInboxMessages, readPushInboxMessage, engagePushInboxMessage, deletePushInboxMessage, and pushInboxUpdateListener APIs. For more information, see Push Inbox API.
  • Added the getInAppMessageCenterCampaigns API to retrieve only in-app message campaigns from the Message Center, and the getMessageCenterCampaign API to retrieve a single Message Center campaign by ID. Both accept optional personalization properties.
  • Added the refreshCampaignsAndResources API to manually refresh all content, including in-app message, Message Center, and Push Inbox content.
  • Added support for control campaigns. In-app message control campaigns are handled automatically, with nothing displayed and the control impression reported for you. For embedded campaigns, the embedded callback now receives an optional third isControl argument, and the new embeddedControlMessageImpressionEvent API reports control impressions.
  • Added Intervals and Blackout Dates for in-app messages and embedded campaigns. For more information, see Schedule triggered campaigns.

Release 2.6.0​

Release date: Febuary 23, 2025

Features​

  • Added getEmbeddedMessageCenterCampaigns API.
  • Added web push notification permission change events for granted and denied states.

Release 2.5.1​

Release date: September 20, 2025

Features​

  • Added icon image to Web Push.

Release 2.5.0​

Release date: March 21, 2025

Features​

  • Added removeMessageCenterCampaign API.

Fixes​

  • Updated dev only third-party dependencies to mitigate some security vulnerabilities.

Note: Added preliminary private code for internal testing of In-App Messages.


Release 2.4.0​

Release date: Jan 13, 2025

Features​

  • Added tracking payload data for push events.

Release 2.3.0​

Release date: March 15, 2024

Features​

  • Updated our third-party dependencies to mitigate potential security vulnerabilities.

Release 2.2.1​

Release date: February 1, 2024

Fixes​

  • Updated the current push subscription status on each session start.

Release 2.2.0​

Release date: December 8, 2023

Fixes​

  • Fixed an issue when the application is closed, which could potentially drop push delivered and engaged events.
  • Fixed an issue where a potential race condition may occur when subscribing to push notifications for the first time.

Release 2.1.0​

Release date: November 23, 2023

Fixes​

  • Resolved a web push issue to ensure tokens are correctly updated within our backend.
  • Upgraded crypto-js to v4.2.0.

Release 2.0.3​

Release date: March 30, 2023

Fixes​

  • Fixed an issue with embedded campaign throttling due to an incorrect UTC DateTime format check.

Release 2.0.2​

Release date: November 2, 2022

Fixes​

  • Removed debug logging to align the Web SDK with the Web Core SDK.

Release 2.0.1​

Release date: July 14, 2022

Fixes​

  • Removed space and length restrictions on event names for consistency across our SDKs.

Release 2.0.0​

Release date: March 9, 2022

Features​

  • Added support for the following features:
  • Added the push delivered event to web push.
  • Moved QA logging to its own queue making it send events independently to the standard event queue, improving reliability and reducing noise when debugging.
  • Added better TypeScript support by including types with our npm package.

Fixes​

  • Fixed a rare issue where appID would break in validation for legitimate app IDs.

Previous releases summary​

DateVersionFeatures and Fixes
January 29, 20211.4.3Various bug fixes.
January 14, 20211.4.2Resolved an issue where duplicate QA events were displaying in the QA user log. Added device type to device update event.
October 23, 20201.4.1Resolved an issue where the browser detection was incorrectly firing an error message on session start.
October 22, 20201.4.0Updated tracking of device OS and type for platform-specific delivery of in-app messages. Resolved an issue where the Device Update event was returning Chrome as the value for all browsers.
September 16, 20191.3.2Resolved an issue where the content URL was not changing appropriately for customers using EU data storage.
July 9, 20191.3.1Tracking will no longer start on unsupported browsers and operating systems and increased the default session interval timeout from 30 seconds to 30 minutes. Various bug fixes.
January 17, 20191.3.0Added the in-app purchase event. Resolved an issue where the autoPushSubscribe config was being ignored.
October 25, 20181.2.1Bug fixes.
October 24, 20181.2.0Multiple additions to package.json meta data and improvements to source maps generation and QA user event logic. Various bug fixes.
October 22, 20181.1.0Added support for web push notifications and currency given event. Various bug fixes.
August 30, 20181.0.0First public release.