Subscription Text Translation

  • Published on May 4, 2026
  • 6 minute(s) read
  • AF
 Prev Next

Feature Overview

When a subscription invoice is created, the app automatically adds a description line below each invoice line. This description communicates the subscription period or product name to the customer in a human-readable format. The Subscription Text Translation feature controls what that description says and in which language it appears.

Translations work at two levels. At the global level, Subscription Texts define a default label per language code — used for all subscriptions. At the item level, Item Subscription Text lets you define a language-specific label for a specific item, overriding the global text when that item appears on a subscription invoice. The language used is determined by the customer's language code on the invoice. If no matching translation is found (neither by language alone nor by language and item combination), the system falls back to the Default Subscription Text Language configured in Subscription Setup.

If no default language is configured in Subscription Setup, the invoice creation process will fail with an error. This means configuring at least one Subscription Text and setting the default language is a mandatory prerequisite for running invoice creation.

Key Facts

Topic Detail
Global translations page Subscription Texts (accessible from Subscription Setup → action bar)
Item-level translations page Item Subscription Text (accessible from Item Card → Subscription → Subscription Text Translation)
Language matching Customer language code on invoice → falls back to Default Subscription Text Language if no match
Format Region Optional per-language setting to control date/number formatting on invoice descriptions
Mandatory setup Default Subscription Text Language must be set in Subscription Setup before invoice creation can run

Getting Started

  1. Open Subscription Setup and verify that Default Subscription Text Language is set to your primary invoicing language (e.g. the code for English or Danish).
  2. Navigate to Subscription Text Translation from the Subscription Setup action bar.
  3. On the Subscription Texts page, add at least one row: enter the Language Code (matching the default language set in step 1) and enter the Subscription Text — the label that will appear on invoice lines for this language.
  4. Optionally add rows for each additional language your customers use (e.g. German, French, Swedish).
  5. For items that need a specific label different from the global text, open the Item Card, go to the Subscription FastTab, and use Subscription Text Translation to add item-specific translations.
  6. Run a test invoice to verify the correct description text appears.

Related Features

Subscription Text Translation is consumed exclusively by Invoice Creation. The invoice creation report calls the text generation logic for each invoice line, passing the invoice's language code to look up the appropriate translation. Without at least one configured translation matching the default language, invoice creation will throw an error.

Subscription Orders themselves do not directly reference text translations — the lookup happens at the moment an invoice is generated, using the customer language on the invoice header.

User Stories

US-01: Set up a global subscription text for invoices in the default language

As a Business Manager
I want to define the standard description text that appears on subscription invoice lines
So that customers receive a clear, readable description on every subscription invoice

Setup:

  1. Open Subscription Setup.
  2. Ensure Default Subscription Text Language is set to your primary language code (e.g. ENU for English or DAN for Danish).
  3. Click Subscription Text Translation from the action bar to open the Subscription Texts page.
  4. Add a row: set Language Code to the same language code as the default, and enter the desired description in Subscription Text.
  5. This text will be used as the fallback for any customer whose language code has no specific translation.
US-02: Add a subscription text translation for a foreign-language customer

As a Business Manager
I want to provide a German-language description for German customers
So that subscription invoice lines for German customers are shown in their own language

Setup:

  1. Open Subscription Setup → Subscription Text Translation.
  2. Add a new row with Language Code = DEU (or the appropriate German language code in your system).
  3. Enter the German description in Subscription Text.
  4. Optionally set Format Region to control number and date formatting on invoice descriptions for this language.
  5. When invoice creation generates an invoice for a customer with Language Code = German, this translation will be used.
US-03: Define an item-specific subscription text that overrides the global text

As a Business Manager
I want to use a product-specific description for a particular item instead of the generic subscription text
So that invoices for that item describe the specific product by name in the appropriate language

Setup:

  1. Open the Item Card for the relevant item.
  2. Navigate to the Subscription FastTab and click Subscription Text Translation.
  3. On the Item Subscription Text page, add one or more rows: each row specifies a Language Code and the item-specific Subscription Text.
  4. When invoice creation runs and this item appears on a subscription line, the item-level text for the matching language takes precedence over the global Subscription Text.

Note: If no item-level text is found for the customer's language, the system falls back to the global Subscription Text for that language, and then to the default language text.

US-04: Set a Format Region to control date and number formatting on invoice descriptions

As a Business Manager
I want to configure a specific format region for a language
So that date and number values in the subscription invoice line description are formatted correctly for that locale

Setup:

  1. Open Subscription Setup → Subscription Text Translation (or the Item Subscription Text page for item-specific translations).
  2. On a translation row, set the Format Region field to the appropriate language tag (e.g. de-DE for German Germany, en-GB for English UK).
  3. The Format Region is used when generating the invoice line description text to ensure dates and numbers match the customer's regional expectations.
US-05: Verify that invoice creation fails gracefully when no default language is configured

As a IT Manager
I want to understand what happens if Default Subscription Text Language is missing
So that I can identify and resolve the issue before it causes failed invoice runs

Setup:

  1. This is enforced automatically. If Default Subscription Text Language in Subscription Setup is blank, the invoice creation report will display an error before creating any invoices.
  2. The error message directs the user to Subscription Setup to set the required field.
  3. No invoices are created until this field is filled in and a corresponding Subscription Text row exists for that language.

Field Reference

Subscription Texts (Global)

Field Where to find it What it does Default
Language Code Subscription Texts page Identifies which customer language this translation applies to —
Subscription Text Subscription Texts page The text displayed as a description line on subscription invoice lines —
Format Region Subscription Texts page Controls date/number formatting for this language in generated descriptions —

Item Subscription Text (Item-Level)

Field Where to find it What it does Default
Item No. Item Subscription Text page The item this translation applies to —
Language Code Item Subscription Text page Identifies which customer language this item-specific translation applies to —
Subscription Text Item Subscription Text page The item-specific text displayed on subscription invoice lines — overrides the global text —
Format Region Item Subscription Text page Controls date/number formatting for this language in generated descriptions —

Subscription Setup – Text-Related Field

Field Where to find it What it does Default
Default Subscription Text Language Subscription Setup → General Fallback language code used when no customer-language-specific translation is found; mandatory for invoice creation —
Related articles

abakion@abakion.com