​

Dashboard sending

From Messages > Push > New Message or Templates, click Add Languages. Choose from:

​

Option 1: Checkboxes

Select languages you support. Any language not selected will fall back to Any/English.

​

Option 2: Import language content

Use the provided template to format the message in each language.

Copy and paste the content back into the “Add Languages” field.

Preview content to double-check, insert content, and new tabs will appear in the editor with the designated content filled out.

​

Option 3: Dynamic Content

Use Dynamic Content which involves creating and uploading a CSV file with the languages you support.

​

Troubleshooting

• English required: Include a row for en as default.
• Use correct headers: language_code, title, subtitle, message
• Comma-separated values: Ensure proper CSV formatting.
• Unsupported language: If not listed in the UI or template, it’s not supported. Use the next best option and contact support@onesignal.com.

​

API sending

The contents and headings fields support multiple languages:

  {
    "contents": {
      "en": "English content",
      "fr": "French content"
    },
    "headings": {
      "en": "English heading",
      "fr": "French heading"
    }
  }

​

Dashboard sending

From Messages > Email > New Message or Templates, choose from:

​

Option 1: Segments

1. Create a segment for each language.
2. Create a template per language.
3. Send each to its corresponding segment.

​

Option 2: Liquid syntax

Use Liquid syntax and property or tag substitution to create conditional statements in the message and render the appropriate content based on the user’s language.

{% assign language = subscription.language %}
{% if language == 'fr' %}
  Bonjour {{ name }}!
{% elsif language == 'es' %}
  Hola {{ name }}!
{% else %}
  Hi {{ name }}!
{% endif %}

​

Option 3: Dynamic Content

Use Dynamic Content which involves creating and uploading a CSV file with the languages you support.

​

API sending

Using the Create message API, you can:

• Target language segments or filters like you would with the dashboard.
• Create message Templates with Liquid syntax utilizing custom_data, property or tag substitution. See Message Personalization for more details on these options.

custom_data bulk personalization example:

{% assign eid = message.custom_data.users[subscription.external_id] %}
Hi {{ eid.first_name }}, you have {{ eid.points }} points. Your level is {{ eid.level }}.

{
  "app_id": "YOUR_APP_ID", 
  "template_id": "YOUR_TEMPLATE_ID",
  "include_aliases": {
    "external_id": ["user123", "user456"]
  },
  "custom_data": {
    "users": {
      "user123": { "first_name": "John", "points": "150", "level": "Gold" },
      "user456": { "first_name": "Sarah", "points": "200", "level": "Platinum" }
    }
  }
}

​

Dashboard - Segments

To send a language-specific In-App Message to each language you need to support:

1. Create a segment for each language.
2. Create an in-app message per language.
3. Send each to its corresponding segment.

​

Tag substitution

Use Liquid syntax and tag substitution to create conditional statements in the message and render the appropriate content based on tags.

language : german
first_name : Jon

{% assign lang = language%} 
  {% if lang == "english" %}
    Good day {{first_name}}!
  {%- elsif lang == 'german' -%}
    Guten Tag {{first_name}}!
  {%- elsif lang == 'spanish' -%}
    Buenos Dias {{first_name}}!
  {%- elsif lang == 'french' -%}
    Bonjour {{first_name}}!
  {% else %} 
    Hello {{first_name}}!
{% endif %}

Guten Tag Jon!

​

Dashboard sending

From Messages > SMS > New Message or Templates, choose from:

​

Option 1: Segments

1. Create a segment for each language.
2. Create a template per language.
3. Send each to its corresponding segment.

​

Option 2: Dynamic Content

Use Dynamic Content which involves creating and uploading a CSV file with the languages you support.

​

API sending

The contents and headings fields support multiple languages:

  {
    "contents": {
      "en": "English content",
      "fr": "French content"
    },
    "headings": {
      "en": "English heading",
      "fr": "French heading"
    }
  }