Articles in this section

Release Notes - Iterable's Web SDK

This document provides release notes for significant updates to Iterable's web SDK.

TIP

For more granular release notes, take a look at the SDK's releases page on GitHub.

# In this article

# 2.3.3

September 29, 2026

Version 2.3.3 of Iterable's Web SDK fixes in-browser message dismissal on Chrome for iPhone and other iOS browsers that do not identify as Safari.

This update includes the following changes:

  • The SDK close button now dismisses in-browser messages in those browsers, including full-screen messages and when isRequiredToDismissMessage is enabled.
  • Chrome on iOS was treated as desktop Chrome, so the close button was placed inside the message, where the browser does not run its click handler. The SDK now detects that case and uses the same close button behavior as Safari.
  • iterable:// and action:// links are still not supported in Safari or in other iOS browsers. Those links do not dismiss the message. Use the SDK close button instead.

# 2.3.2

September 24, 2026

Version 2.3.2 of Iterable's Web SDK is a security maintenance release.

This update includes the following changes:

  • Bumped the axios dependency to v1.18.0, which resolves the outstanding prototype pollution, proxy bypass, and denial of service advisories reported against v1.14.0. There are no API or behavior changes, so you only need to update the SDK version in your project.

# 2.3.1

August 18, 2026

Version 2.3.1 of Iterable's Web SDK completes preferUserId configuration for user identification.

This update includes the following changes:

  • Pass preferUserId through setUserID and JWT-mode setEmail into the identify-time /users/update call. In 2.3.0, callers could already set preferUserId on updateUser, updateCart, and trackPurchase, but setUserID / setEmail still forced preferUserId: true. You can now pass it as the third argument, for example setUserID('user-123', undefined, false), and the SDK defaults to true when you omit it.

# 2.3.0

July 21, 2026

Version 2.3.0 of Iterable's Web SDK makes preferUserId configurable.

This update includes the following changes:

  • Made preferUserId caller-configurable on users/update, updateCart, and trackPurchase requests. Previously the SDK hardcoded preferUserId: true, overriding any value passed by the caller. The SDK now honors the value you provide and still defaults to true when you don't set one, so existing behavior is unchanged unless you explicitly opt out. Note: configuring preferUserId on setUserID / setEmail requires 2.3.1 or later.

# 2.2.2

March 31, 2026

Version 2.2.2 of Iterable's Web SDK includes a bug fix and a security update.

This update includes the following changes:

  • Fixed an issue where the user email was missing from in-app event payloads.
  • Pinned the axios dependency to v1.14.0 to address a security vulnerability.

# 2.2.0

September 3, 2025

Version 2.2.0 of Iterable's Web SDK includes support for Unknown User Activation, which is available in beta; for information about adding it to your project, talk with your Iterable customer success manager.

This update includes the following changes:

  • Adds support for capturing user consent with Unknown User Activation.
  • Updates to the Unknown User Activation feature to resolve minor issues and bugs.

# 2.0

June 23, 2025

Version 2.0.0 of Iterable's Web SDK addresses security vulnerability alerts. To install this version, you must install node.js v18.12.0 or later, if you haven't already done so.

For details about migrating to the new version, read the Web SDK release notes on GitHub. This will require:

  • webpack-dev-server to latest (5.2.1)

  • webpack-cli to latest (6.0.1)

  • node engine requirement (18.12.0)

# 1.1.0

June 12, 2024

Version 1.1.0 of Iterable's Web SDK brings GA support for Embedded Messaging, including support for out-of-the-box views (cards, notifications, and banners).

For more information, read:

Documentation for out-of-the-box views in the Web SDK is coming soon.

# 1.0.5

August 31, 2023

Version 1.0.5 of Iterable's Web SDK supports Iterable's European Data Center.

For more info, see Setting Up Iterable's Web SDK.

# 1.0.0

October 31, 2022

This is the initial release of Iterable's web SDK. You can use this SDK to display in-browser messages (in-app messages that target a website) sent from Iterable and track related events.

For more information about Iterable's web SDK, check out:

# Deprecation dates and support windows

This table lists deprecation dates, support windows, and end-of-life dates for various versions of Iterable's Web SDK.

SDK version(s) Deprecation announcement date Support window End-of-life date
1.1.x (current)
1.0.x 6/12/2024 12 months 6/11/2025

NOTES

  • If a version of Iterable's Web SDK is not listed here, it is no longer supported.
  • For more information, see our SDK Support Policy.

# Further reading

Related articles