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

OneSignal features - Supported languages

The OneSignal SDK will automatically detect the language set on the device/browser.

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 for all new messages, but you can use any language you desire in this field. Think of "English" as "Default". For example if you enter a Spanish message into the "English" field, then all users will get the notification in Spanish.

If you want to send a single message in more than one language, you can add languages by clicking the pencil in New Message. To learn more about this, please see Sending Notifications.

FAQ

How can I send the notification in a language other than English?

"English" (or "en" with the API) is the Default language. Think of this as default.
To send a notification without English, you can put your desired language in the English field and all devices will get the desired language.

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

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

Romanian

ro

Russian

ru

Serbian

sr

Slovak

sk

Spanish

es

Swedish

sv

Thai

th

Turkish

tr

Ukrainian

uk

Vietnamese

vi

Language & Localization


OneSignal features - Supported languages

Suggested Edits are limited on API Reference Pages

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