home

Zuora Billing

Zuora BillingZuora PaymentsZuora PlatformZuora CPQZephrZuora RevenueAccounts ReceivableRelease NotesBasicsEntitlementsSupport and policies
Zuora BillingZuora PaymentsZuora PlatformZuora CPQZephrZuora RevenueAccounts ReceivableRelease NotesBasicsEntitlementsSupport and policies

Welcome to Zuora Product Documentation

Explore our rich library of product information

Show Contents

thumbnailZuora Billing

Multilingual support in Word billing document templates

Create and upload a translation profile

Learn how to create and upload a translation profile for billing documents, ensuring merge fields are translatable and correctly formatted.

A merge field value can be translated if all of the following are true about the merge field:

  • A supported merge field name or SPECIAL.PPOC is used.

  • The merge field is not marked as untranslatable.

  • The field type is string.

For the names, types, and translatability of merge fields, see Merge Fields for Invoices, Merge Fields for Credit Memos, or Merge Fields for Debit Memos.

To create and upload a translation profile, complete the following steps:

  1. Click your username at the top right and select Billing.
  2. In the Billing Settings screen, select Manage Billing Document Configuration.
  3. Click the Translation Profile tab.
  4. From the Choose Template Format drop-down list, select Word .
  5. Click export.

    A sample translation file will be downloaded. This file contains two columns:

    • MergeFieldName: The merge field name as it appears in the billing document template. For a list of supported merge fields, click here.

    • OriginalValue: The value in the default language of your tenant. The maximum allowed length is 500 characters.

  6. Add the target languages to the remaining columns. For each column heading, type the language code (e.g., de-DE). Language codes are case-sensitive, so ensure accuracy by referring to the Supported languagessection below. Each column has a maximum allowed length of 500 characters.
  7. Save the translation file. If you use Microsoft Excel, save it in the Windows Comma Separated (.csv) format.
    Note:

    • Do not save in the MS-DOS Comma Separated (.csv) format.

    • You must save the translation file in the UTF-8 Format.

  8. In the Import Translation Profile section, click Choose File , select the translation CSV file, and click Import .
  9. Review the import summary and click OK .
  10. Click and select a language in the translation file to review the translation.

    Now, you can manage billing document template files and generate billing document PDF files as described in Customize Billing Document Templates Using Word Mail Merge.

    Below is an example translation profile. The two merge fields will render translated values based on the profile. All other merge fields will display in the default language used in the product catalog.

    MergeFieldName

    OriginalValue

    fr-FR

    de-DE

    Subscription.Product. Name

    Best Product Ever

    Meilleur Produit Jamais

    Beste Product aller Zeiten

    Subscription.RatePlan. Name

    Best Product Ever - Gold Edition

    Meilleur Produit Jamais - Edition d'Or

    Beste Produkt aller Zeiten - Gold Edition

Last updated: December 16, 2025