This article will explain how to localize your notification templates and how the different language and country versions are triggered. If you are new to creating Notifications templates, we recommend starting with this article: Create and edit templates for Notifications
Sections in this article:
- Create a localized version of a template
- Use case
- The language and country logic explained
- Send product feedback
Create a localized version of a template
- When you have created a new template, you will be sent to the following screen where you can add additional languages. A new template will always be created as a default template and work with any shipment language and any destination country. If you only need to communicate in one language to all everyone, you only need the default template.
- Click the Add button to create a localized copy of the template.
- The editor now opens with a copy of your default template. Start by selecting the language and the destination country. Use of the language requires that you specify the language on each of your shipments. It is a value that is entered when creating a shipment.
- Fill in the general information, translate the template and make any adjustments needed to the local version.
- Click Save. You will now see the local template below the default template. Add more localized templates if needed.
This use case will look at a specific scenario to illustrate how localized notification templates can be used.
Company Z is an international company that ships products to the Nordics (DK, NO, SE and FI), Germany, Switzerland, the US, and the UK. They want to send out an email notification when an order is shipped to let their customers know that their parcel is on the way.
To give their customers a localized experience, they have created the following templates:
- The default template is in English. This will be used in all the cases where there is no localized template matching the shipment language or destination country on the shipment. This means that the default template will be used when they ship orders to the UK and the US.
- For the Nordic countries and for Germany, they have created one localized template for each country.
- For Switzerland, they have created 4 templates, one for each of the national languages.
For the majority of customers, it will be sufficient to have a default template and a few localized templates. See the section below to understand how templates are matched in a more advanced setup.
The language and country logic explained
This section is for customers who have a complex setup with many localized templates and destination countries and who wish to understand the logic behind the matching of templates.
- The shipment language is a value set on the shipment when it is created. This is the first value that the Notifications logic will look at. If a match is found, the logic will look at the destination country to find a match. If the shipment language finds a match but no match is found on the destination country, then the default template will be used.
- If no shipment language exists or if there are multiple matches, the logic will look at the destination country to find a match.
- If a shipment language exists but doesn't match any of the templates, the default template will be used, even if there is a match for the destination country. For example, a shipment with shipment language French to Canada will not use an English template to Canada.
- If no single match can be found for the destination country, the default template will be used. For example, if you have four templates to Switzerland and no value for the shipment language is given then the default template will be used because there are several matches for the same destination country.
Send product feedback
If you would like to give us product feedback and help improve Notifications, please follow the steps below:
Click here to fill out the feedback form.
- Select Customer Service.
- Fill in your email address.
- Fill in a subject starting with BETA. E.g. "BETA - feedback about notifications". This is very important to make sure your feedback ends up in the right department.
- Write your feedback in the Description field.
- Choose your Country.
- Choose DeliveryHub as the nShift product.
- Choose Service request under Type.
- Click Submit.