Customize translations

important

The documentation in this topic refers to a feature or product that is currently in Early Availability status. Features in Early Availability status are only available in production to a limited number of customers based on fit with specific use cases. For more information about Early Availability status, see Product lifecycle phases. If you would like to use the product capabilities described here during the Early Availability phase, contact your AppDirect technical representative.

📝 Note: If the AppDirect logo appears in the upper-left corner of the page, when Manage > Marketplace appears in this topic, click the grid icon > Switch to | Store, instead.

You can customize the translation for text and labels in your marketplace by using the Customize Translations feature. This feature allows you to change the text on pages that are not already affected by the storefront theme.

When enabled, this feature replaces the default Translation feature. For details on translation feature, see Create and manage translation keys.

To use this feature, navigate to the Customize Translations page:

Manage > Marketplace > Settings > CUSTOM UI | Customize Translations

The page has two panes:

• DOWNLOAD TRANSLATION FILE
  This pane displays a Download button.
• UPLOAD TRANSLATION FILE
  This pane displays an Upload CSV file field for the translation file to be uploaded, along with a Choose File button so you can navigate to the file, and an Upload button to upload it once you have chosen it.

The Download button downloads a comma-separated value (CSV) file that lists the text and labels for elements of the marketplace UI in all languages that marketplace supports. It includes several columns:

• namespace
• bundle
• key
• Two columns for each supported language in the marketplace:
  • *<language_code>
  • *<language_code>'_'<marketplace_company>

You can download this file, add new labels in each <language code>'_'<marketplace_company> column, save the changes, and then upload the modified file. The system then reads the desired labels, and displays the new labels appropriately in the marketplace.

When the Customize Translations feature is enabled, the marketplace has access to a special Klingon language that displays the unique label key that identifies each label or piece of text. (Klingon was selected for this purpose because it has an official code, but is never used for localization.) When you want to change a label, you can use this language to display the key and note it down. You can then search for it in the CSV file to locate the row you need to change.

To customize translations in your marketplace

1. Navigate to the Customize Translations page:
   Manage > Marketplace > Settings > CUSTOM UI | Customize Translations
2. In the DOWNLOAD TRANSLATION FILE pane, Click Download to download the CSV file.
3. Open the CSV file in an editor (for example, a spreadsheet editor).
4. Find the row that matches the label you want to modify.
   You may first need to check the marketplace to find the label key. For more information, see Finding a label key section, below.
   In some cases, the same key may appear twice: once with "monolith" in the namespace column, and once with a different namespace. When this is the case add the new label to the row with the other namespace, as this row takes precedence over the “monolith” namespace entry.
5. In the <language code>'_'<marketplace_company> columns, add new text for the label.
6. Repeat these steps for each item you want to change.
7. When you are done, save your changes.
8. Return to the Customize Translations page. In the UPLOAD TRANSLATION FILE pane, click Choose File, navigate to your modified file, and select it.
9. Click Upload.
   The system uploads the modified file.

The change may take up to 15 minutes for some items, though most will appear with the updated label right away.

Finding a label key

To display the label key in the marketplace so you can search for it in the CSV file:

1. Navigate to the marketplace page that contains the label or text.
2. Using the language selection toggle at the very bottom of the marketplace display, select Klingon.
   The key name appears in the place of the label or text.
3. Note the key for the label(s) you want to change.
4. When you have noted the key(s) you want, change the marketplace language back.