3.4.0

3.4.0 (2025-09-19)

Features

• add new custom events trackEvent method (40deef9)

3.3.0

3.3.0 (2025-09-11)

Fixes

• fix commonjs entry point issues (2f24a45)

3.2.3

3.2.3 (2025-06-06)

Changes

• improve types for setLogLevel method
• pass welcomeNotification.disabled as disable to web SDK
• set welcomeNotification.url to be optional
• await OneSignalDeferred to complete processing for endpoints such as getTags() and getLanguage()
• improvements to distributed bundle size

3.2.2

3.2.2 (2025-03-28)

Bug Fixes

• add promise reject for init call (daadfa8)

3.2.1

3.2.1 (2025-03-27)

Bug Fixes

• lower node engines range (216c428)

3.2.0

3.2.0 (2025-03-24)

Features

• sync with web-shim-codegen v3.0.2 (1a23688)

3.1.1

3.1.1 (2025-03-14)

• Add Language functions to User model (Resolves #143)
• Add missing types UserChangeEvent & new properties (OneSignal/web-shim-codegen@6ae24c1)
• Update function templates to support non-void return types (OneSignal/web-shim-codegen@a3ac32f)

3.0.1

What's Changed

• Fix server-side rendering in frameworks like Next.js erroring on window.

Full Changelog: 3.0.0...3.0.1

3.0.0

⚠️This is a major release which contains breaking API changes ⚠️

In this major version release for the OneSignal SDK, we are making a significant shift from a device-centered model to a user-centered model. A user-centered model allows for more powerful omni-channel integrations within the OneSignal platform.

Migration Guide

Check out the User Model Migration Guide to get high level understanding of the concepts in this major release.
For code specific change to upgrade your site from v2 to v3 see the onesignal-react specific migration guide.

3.0.0 Release (Beta 5)

What's Changed

• Update migration guide
• Check to see if we are in a client environment (prevent SSR errors)
• Type definition improvements
• API Changes

API Changes

• Notifications namespace: new permission & permissionNative properties. Remove getPermissionStatus.

• Rename subscriptionChange event to change

• Generator Update by @onesignal-deploy in #106

• Generator Update by @onesignal-deploy in #109

Full Changelog: 3.0.0-beta3...3.0.0-beta5