2.3.0

2.3.0 (2025-09-19)

Features

• add new custom events trackEvent method (aaac2d8)

2.2.2

2.2.2 (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

2.2.1

2.2.1 (2025-03-28)

Bug Fixes

• add promise reject for init call (da28464)

2.2.0

2.2.0 (2025-03-24)

Features

• sync with web-shim-codegen v3.0.2 (7bca3c5)

2.1.0

2.1.0 (2025-03-18)

Features

• sync with web-shim-codegen v3.0.1 (ce65df3)

2.0.1

What's Changed

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

Full Changelog: 2.0.0...2.0.1

2.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 v1 to v2 see the onesignal-vue3 specific migration guide.

2.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

• Issue templates by @rgomezp in #12

• Remove unnecessary eslint file by @rgomezp in #13

• Adding the release drafter action by @emawby in #16

• Close Asana tasks generated from Github issues by @emawby in #15

New Contributors

• @emawby made their first contribution in #16

Full Changelog: 1.0.2...2.0.0-beta.5

2.0.0 Release (Beta 3)

What's Changed

• Include tag functions that were previously missing
• SSR compatibility bugfix
• Generator Update by @onesignal-deploy in #22
• Generator Update by @onesignal-deploy in #23

Full Changelog: 2.0.0-beta.2...2.0.0-beta.3

2.0.0 Release (Beta 2)

What's Changed

• Generator Update by @onesignal-deploy in #20
• Generator Update by @onesignal-deploy in #21

Full Changelog: 2.0.0-beta.1...2.0.0-beta.2