The OneSignal SDK will automatically detect the language set on the device or browser settings. You can use this data to create Segments or localize Push Notification Messages.

🚧

Limited to Push Notifications

Message Localization is limited to push notifications only at this time. To target emails and in-app messages by language, you must create Segments for the language to target each one individually.

Creating Notifications in Multiple Languages

The OneSignal dashboard and API makes "English" the default language, but use any language you need in this field. Think of "English" as Default. For example if you enter a Spanish message into the "Any/English" field, then all users will get the notification in Spanish.

To send a message in multiple languages, select Add Languages.

OneSignal will show how many subscribers have each language.

Select the languages you want to use in the push. Any languages you do not select will get the "Any/English" message.

You must provide the translation for each message you want to include.

FAQ

How can I change the default language to not use English?

"Any/English" (or "en" with the API) is the Default language. To send a notification without English, you can put your desired language in the English field and all devices will get the language you set.

For example, if you want all notifications to have a Spanish language, just put the Spanish message in the English field or "en" on the API. All users will get the Spanish message.

Does OneSignal support RTL?

Support for RTL is handled by the Operating System level so it should be supported depending on the language and the user's phone settings.

How do I use a different language than the device settings?

If you do not see the language you want to support on our list or you allow users to set their own language, then you will need to differentiate the users and target separately.

One option is to tag users with the language, then create segments by each tag. Then send notifications separately by adding the language to the "en" or English field.

If you track this data in your CRM or Database, you can target via our API as well. See Internal Database, DMP, & CRM.

What languages are supported?

The following are languages supported by OneSignal: