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

Sending Notifications

OneSignal Features - Sending Notifications

For Developers
For Marketers

Notifications can be sent via the dashboard on the New Messages Page.

Multiple Languages

The default notification title and contents are sent to:

  • All English users
  • All other users you do not specify a language-specific title and content for

You can click Add another language to add a language-specific title and content:

For example, to target Spanish, Turkish, and Finnish users:

  1. Fill in the default Title and Content. This is always required, and is sent to any users who are not Spanish, Turkish, or Finnish (e.g. English or other users).

  2. Click Add another language and select Spanish, Turkish, and Finnish. Supported Languages

  3. Fill in the Title and Content for each of your three new languages.

Selecting Users

There are three options to select which users receive your messages

Option
Description

Send to Everyone

Sends to all users.

Send by Segment

If you've set up User Segments, you can both include and exclude segments to send to.

Send to Test Users

Allows you to select which Test Users to send to. Useful when you're testing new notifications and what to see how they look on devices.

Selecting Platforms

The Platforms & Options link expands to show you options to send notifications to specific platforms, and customize the presentation and features of those notifications. These features are explained by hovering over the question mark next to each option.

Platform / Option
Description

Send to iOS Subscribers?

Send to iOS devices.

Send to Android Subscribers?

Send to Android devices.

Send to Amazon Fire Subscribers?

Send to Amazon devices.

Send to Windows Phone 8.0 (MPNS) Subscribers?

Send to Windows Phone 8.0 devices.

Send to Windows Phone 8.1 (WNS) Subscribers?

Send to Windows Phone 8.1 devices.

Send to macOS Subscribers?

Send to macOS devices.

Send to Chrome App Subscribers?

Send to Chrome Apps & Extensions. This is not Web Push

Send to Chrome Web Subscribers?

Send to Chrome browsers (Web Push).

Send to Safari Web Subscribers?

Send to Safari browsers (Web Push).

Send to Firefox Web Subscribers?

Send to Firefox browsers (Web Push).

Include Additional Data?

Default is OFF

Custom key values pairs sent to your app when the notification is opened. See our SDK API documentation for details on how to read the data in your app.

Launch URL?

Default is OFF

Opens a web browser to the URL when the user taps on the notification.

Include Android / iOS Action Buttons?

Default is OFF

Buttons show on the notification itself. Works on iOS 8.0+, Android 4.1+, and ChromeApps using our official SDKs.

Include Chrome Web Push Action Buttons?

Default is OFF

Chrome 48+: Up to two actions buttons can be shown on a web push notification. Action button icons are only supported on Chrome 50+.

By default, all device platforms are enabled. You can toggle whether to send your notification to individual platforms by clicking the 'Yes' button:

This collapses the section and does not send to devices on selected platform. For example, iOS users will not receive notifications when the menu looks like this:

Selecting Options

Links

To send a link, enable the Launch URL option and type in the link. Be sure to include the full URL including http:// or https://. This will open an external link when the notification is tapped. To learn more about links, including deep linking, take a look at our Links documentation

iOS - To have links open in an in-app browser, take a look at the key settings in the iOS Native SDK.

Scheduling

Clicking the Schedule / Send Later item lets you select among different notification delivery scheduling options:


FAQ

How do I send a notification to a single user?

For Developers

If you're looking to send notifications to a specific user device:

  1. Get the user's userId/playerId with the getIdsAvailable or getIds SDK method. See the SDK reference to find example code.

    For testing you can use the 'Player ID' shown in All Users (you can force kill your app and open it again to bring your device to the top of the list.)

  2. Send the userId from getIdsAvailable or getIds if the pushToken is not null or blank to your server.

  3. Set include_player_ids to the userId on the PostNotification SDK method or on the Create notification POST REST API call.

This method can be used for User-to-User notifications.

Sending Notifications

OneSignal Features - Sending Notifications

For Developers
For Marketers