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

Language & Localization

Supported Languages in OneSignal Push Notifications

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:

Language

Language Code

English

en

Arabic

ar

Azerbaijani

az

Bosnian

bs

Catalan

ca

Chinese (Simplified)

zh-Hans

Chinese (Traditional)

zh-Hant

Croatian

hr

Czech

cs

Danish

da

Dutch

nl

Estonian

et

Finnish

fi

French

fr

Georgian

ka

Bulgarian

bg

German

de

Greek

el

Hindi

hi

Hebrew

he

Hungarian

hu

Indonesian

id

Italian

it

Japanese

ja

Korean

ko

Latvian

lv

Lithuanian

lt

Malay

ms

Norwegian

nb

Persian

fa

Polish

pl

Portuguese

pt

Punjabi

pa

Romanian

ro

Russian

ru

Serbian

sr

Slovak

sk

Spanish

es

Swedish

sv

Thai

th

Turkish

tr

Ukrainian

uk

Vietnamese

vi

Updated about 2 hours ago



Language & Localization


Supported Languages in OneSignal Push Notifications

Suggested Edits are limited on API Reference Pages

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