Skip to main content

Single-File Translation Sync (AJO)

Guide to help you zip all translated variants into a single email for Adobe Journey Optimizer

What It Does

Single-file Translation Sync lets you consolidate multiple language versions of an email into one dynamic content template in AJO. The correct version appears automatically based on your recipient's language settings.

Demo Video


Setting Up Single-file Translation Sync

Before you can use Single-file Email Sync, you'll need to enable it in your AJO integration settings:

  1. Go to Admin > Integrations > Platforms.

  2. Find your AJO integration and click the pencil icon to Edit Your Connection.

    Knak UI for connected AJO Integration.
  3. Click Advanced Options.

  4. Enable Single-file translation sync.

  5. Enter your language variable (see next section).

    Advanced Options with Single-file setting enabled.
  6. Click Save.


Set Your Language Variable

Make sure the language variable matches your AJO profile schema.

  1. In AJO, go to Customer > Profile.

    Customer Profile section in AJO.
  2. Select the Union Schema view.

    Union Schema view in AJO.
  3. Open up all the variables saved on a profile in your integration and review the profile’s variables.

    • For example, if your language field is nested under languagePreferences, enter:

      profile.languagePreferences.preferredLanguage
      Language preferences tree view in AJO.

Note: Knak uses two-letter language codes by default (eg. French is “fr”, not “fr-fr”). If you use a different variation of language codes, please reach out to your CSM to have your list updated.


Using Single-file Translation Sync

After setup, you can sync any translated email into AJO.

  1. Create your base email in Knak.

  2. Create translations using Knak’s translation features.

  3. Select your base email.

  4. Choose your AJO integration.

  5. Name your email.

  6. Click Sync.

Your synced email appears in the Content Templates section of AJO.

Note: When Single-file Translation Sync is on, you can't sync language variants one at a time. The toggles for individual variants are turned off. All variants sync together with the base email as one package.


Previewing Your Single-file Email

You can preview how each translation will render inside AJO.

Note: The default preview in AJO may look unclear. This is because the template uses conditional (if) statements to show each language version. Use Simulate Content to see how each version will render.

  1. Open your synced email in AJO.

  2. Go to Simulate Content > Simulate Content Variations.

  3. Click Create Sample Input.

  4. Update the language code in the text box to sample how the different language variants will render

    Sample input field with language code preview.

Best Practices

  • Complete all translations before syncing. ✅

  • Confirm your language variable matches your AJO schema. ✅

  • Preview all versions after syncing to confirm correct rendering. ✅


Need more help? Contact support via live chat within Knak using the chat bubble in the bottom right corner or email support@knak.com.

Did this answer your question?