OneSignal Help & Documentation

Welcome to the OneSignal New IA developer hub. You'll find comprehensive guides and documentation to help you start working with OneSignal New IA as quickly as possible, as well as support if you get stuck. Let's jump right in!

Get Started    Discussions

Safari Web Push Setup

How to add Safari support to your Web Push setup.


Chrome & Firefox Setup Required

You must already have set up Chrome & Firefox before adding Safari. Go to Web Push Quickstart to begin.


macOS Only

Safari on iOS does not support web push. See our list of supported browsers here.

Apple does not support web push on iPhone and iPad at this time.

How to add Web Push for Safari

Adding Safari is an optional step for setting up web push

  1. Go to Settings and click Apple Safari to Configure the platform.

  2. Type in your Site Name.

  3. Type in the same Site URL as you typed above, except don't enter trailing slashes or subfolders.

  4. If you don't have a .p12 certificate file, don't upload one.

  5. Upload your site's icon. You must upload a 256 x 256 icon.

  6. Press Next to select "Web Push" or "WordPress"

  7. On Install SDK you should see "Your Safari Web ID:"

If you are using Typical Setup you are done, press "Save" and you should be able to subscribe to the site on Safari if you have macOS.

If you are using Custom Code Setup, then copy the Safari Web ID like this:

then in your site's OneSignal Init code, add the safari web id as a string this:

safari_web_id: "YOUR_SAFARI_WEB_ID",

Full code example:

<script src="" async=""></script>
  window.OneSignal = window.OneSignal || [];
  OneSignal.push(function() {
      appId: "8e04addd-be31-43dc-8c7a-0618eb781972",
      safari_web_id: "",
      notifyButton: {
        enable: true,


Safari Icon and Site Name

Due to Safari's custom web push implementation, your site name and icon image are treated as static resources downloaded and stored locally on the user's computer. New site names and new images are not updated or downloaded.

Unfortunately anyone subscribed with these older resources will need to clear the Safari push permissions and return to the site to resubscribe.

Wordpress Safari Setup


You're all done! Safari should show up as a platform you can send to.

Uploading your own p12 cert

Make sure you create a Website Push ID in your Paid Apple Developer account.

Updated about a month ago

Safari Web Push Setup

How to add Safari support to your Web Push setup.

Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.