Self Hosting the JavaScript Web SDK

Don't Host It Yourself If You Don't Need To

From time to time, we add new features and bug fixes to our SDK. Changes are always backwards compatible, so you won't receive errors if you don't update, but you wouldn't be able to take advantage of the new features and fixes either.

If you choose to use our CDN-hosted version, we make the best effort to configure easy rollbacks in events of things not working. We host this file on Cloudflare's international CDN with a 2 or 3 days browser cache duration. OneSignal is used widely enough that many users will already have this file in their browser cache when they visit a new client's website. In cases where we plan to make an update to it in the near future, we will sometimes temporarily lower the browser caching duration so that the previous version is promptly expired much sooner.

Technical Instructions

HTTPS Web Push Integrations