Web Changelog

The latest updates to the Airship Web SDK

v1.22.2 May 24, 2024

This release fixes some minor defects. It is fully backward compatible with existing installations.

  • fix some issues with autogenerated docs for custom events
  • introduces a workaround for chrome incorrectly reporting web push permission status in some cases
  • transpile external modules for ES5, matching the rest of the SDK’s compilation target

v1.22.1 November 7, 2023

  • fixes mobile Safari “standalone” detection inadvertently including desktop Safari 17

v1.22.0 October 31, 2023

  • Fix an issue when re-evaluating a feature flag audience condition
  • Support emitting feature flag interaction events

v1.21.7 September 5, 2023

Internal-facing fixes and optimizations.

v1.21.6 August 31, 2023

No user-facing changes.

v1.21.1 August 22, 2023

  • Fixes an issue in feature flag audience evaluation where some comparisons were always done case insensitively
  • Updates remote data (feature flags, preference centers) caching to align with other Airship SDKs

v1.21.0 August 16, 2023

  • Add support for Feature Flags
  • Support specifying the version string of your app when configuring the web SDK, by passing appVersion when initializing

This release has no backward-incompatible changes; when new features are not used, behavior is identical to the previous release.

v1.20.1 May 4, 2023

  • Fixes a rare issue where named user identifiers could be cached indefinitely, causing some workflows to fail if the user id was disassociated by another process.

v1.18.0 March 6, 2023

This minor release adds support for mobile Safari web push in iOS 16.4.

In mobile Safari:

  • sdk.canRegister will only be true if in “standalone” mode; that is, if the app is added to the home screen. Mobile Safari only supports web push when in this mode.
  • Attempts to call sdk.register() when in an unsupported context will reject with a relevant error
  • SDK registration plugins, such as the HTML Prompt will not prompt for opt-in unless in a supported context.

This release is backwards compatible, and mobile Safari will automatically be supported, in supported contexts, on any VAPID-enabled integration. However your website may need updates to support these contexts; see iOS Safari docs for further details.

v1.17.1 April 4, 2022

This minor release adds new types describing cross channel preference centers as well as scoped subscription list management for contacts.

This release has no backward-incompatible changes; if these features are not used, behavior is identical to the previous release.

1.16.0 September 30, 2021

This minor release adds new options for triggering an email double opt-in either via registration call, or opt-in form.

This release has no backward-incompatible changes; when these options are not specified, behavior is identical to the previous release.

1.15.0 September 14, 2021

This release adds a number of new features, and deprecates some existing ones. No code changes will be necessary in your existing integrations, but for new or updated integrations it’s recommended that you use the new APIs.


The new Contact interface replaces the existing UaSDK.Channel.NamedUser API, providing the following benefits:

  • Tags and attributes may be set at any time, before the user is given a name; the data you set will be carried over to a new named user once identified
  • A more consistent experience for users of our iOS/Android SDKs
  • Register and associate email/sms/open channels with the current contact

Note: you should not use the deprecated NamedUser SDK APIs and the new Contact simultaneously, or you may have unexpected behaviors.

Preference Centers

New SDK APIs allow you to implement preference centers on your website, see the topic guide for further information.

Note: Preference Centers are only available if your plan has access to this feature.

Opt-In Forms

A new plugin has been added which provides a pre-made form for registering email and SMS channels on your website. For additional information, see the plugin documentation.

Note: Opt-In Forms are only available if your plan has access to this feature.

1.14.0 August 10, 2021

  • Add support for AMP websites

1.13.0 March 15, 2021

  • Improvement: Allow passing query parameters in the service-worker URL

1.12.0 February 22, 2021

Minor changes on data-collection to match our mobile SDK behavior.

1.11.0 January 13, 2021

Minor release:

  • add locale override support

1.10.0 September 3, 2020

Minor release:

  • Add support for Yandex browser
  • Fix a regression on Safari

1.9.0 August 27, 2020

Minor release including:

  • Add data collection handling to match mobile SDK
  • Internal changes to prevent flooding the backend (channel events capping, named user debouncing)

1.8.2 August 14, 2020

Patch release:

  • make the unsupported-browser error catchable using UA.catch()
  • fix default positioning of HTML prompt alert template to top when incorrect or not defined

1.8.1 August 12, 2020

Patch release to fix a reporting bug with uppercase button IDs.

1.8.0 August 4, 2020

Minor release for web notification button support and a bug fix for named users.

  • Added support for displaying buttons in web notification
  • Fixed bug where clicking a web notification could remove named user from the channel

1.7.0 June 15, 2020

Adds support for setting attributes and tags on named users.

1.6.0 May 5, 2020

Minor release that adds date attribute support.

1.4.0 March 23, 2020

Minor release introducing a new plugin framework, and two plugins to make user acquisition easier.


  • Introduced a new plugin framework
  • Added customizable HTML prompt plugin
  • Added registration page plugin