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    Support

Thanks for Subscribing Notifications

Tutorial - Setting up welcome notifications for Web Push (Chrome, Firefox, and Safari).

For Developers

Web Push

How do I customize or disable the automatic welcome notification when a new site visitor subscribes?

Use the welcomeNotification parameter in your init() options. The url parameter is, by default, set to a special value that, on Chrome and Firefox, disables the notification from opening a separate webpage. By default, Safari must open a webpage and it will default to your site's URL. You may optionally set url so the notification opens a separate URL (on Chrome, Safari, and Firefox).

Showing a Welcome Notification

// Do NOT call init() twice
OneSignal.push(["init", {
    /* Your other init options here */
    welcomeNotification: {
        "title": "My Custom Title",
        "message": "Thanks for subscribing!",
        // "url": "" /* Leave commented for the notification to not open a window on Chrome and Firefox (on Safari, it opens to your webpage) */
    }
}]);

Disabling Welcome Notifications

// Do NOT call init() twice
OneSignal.push(["init", {
    welcomeNotification: {
        disable: true
    }
}]);

Thanks for Subscribing Notifications

Tutorial - Setting up welcome notifications for Web Push (Chrome, Firefox, and Safari).

For Developers