pixi

Managing Multiple Languages in a Single Template


With the new dynamic language selection feature in pixi, you can now manage multiple languages within a single template (for example, an invoice or delivery note). Instead of creating separate templates for each language, or working with different printing rules, you simply define one default template and add language-specific translations directly within it. This approach simplifies the template management: any design or content updates need to be made only once, while localized labels and static text are automatically adjusted based on the order’s language tag.


This functionality is available for the reports designer under Administration > Templates. It is not available for Controlling > Reports.


How a Template is Selected Automatically

Template languages are automatically applied if an order import includes a language tag and a template for the dedicated language exists. The system reads language tags (such as language and locale: fr-FR) imported from the order data and dynamically applies the language. The dynamic language selection works for the following documents:

  • Delivery Note

  • Invoice

  • Return Form

  • Gift Note

  • Customs Document

  • Credit Note

If you'd like to create a new language tag, note that the tag needs to start with the word "Language: ". For example "Language: de" or "Language: nl-BE" for more specific localization needs. All available locale identifiers are in listed in the tag editor (see step 9 in Creating a Language-specific Template).


Creating a Language-specific Tag

If you do not have language specific tags created in your system yet, follow these steps:

  1. Navigate to Administration > Tags.

  2. Click the + icon in the top menu bar.

  3. Fill out the information:

    1. Name: The name of your tag, for example "Language: de"

    2. Tag type: Orders (Important: The language selection only works for the Order tag type)

    3. Description: An optional description for further information.


  4. Click Save.


Creating a Template with Different Translations

To create a single template with one or more languages:

  1. Go to Administration > Templates.

  2. Click the + icon to create a new template.

  3. Open the tab Setup.

  4. Enter the following information:

    1. Name: The name of your template (e.g. Invoice (DE) if you want to create a template for an invoice in English)

    2. Description: Optional – you can enter a description for the template here.

    3. Type: Select the document type for which the template should be created (e.g. Invoice)


  5. Click Create.

  6. Open the tab Setup.

  7. Open the menu in the top left corner of the editor.

  8. Click Localization...


  9. Select your desired language.


  10. Add the translations in the dedicated fields (in this case GERMAN).


  11. Save your template by clicking the disk icon in the grey menu bar on the left.

  12. If you'd now like to also translate the label fields into Spanish, open the Localization... menu and select Language. Enter "Spanish" and select "es-ES".

  13. Add the translations into the fields.

  14. Save your template by clicking the disk icon in the grey menu bar on the left.

The document type that has the stored translations and is assigned language tags via the order data have their language templates selected accordingly.


If there is no template available or saved for a specific language, pixi will select the default template. If there are several language tags, only the first one will be selected for the output document.


Back to top