Skip to main content

Using XLIFF Translations

Learn how to download, translate, and upload XLIFF files to manage manual translations in Knak.

Updated over a week ago

Knak supports multiple translation options. These include Knak AI, manual translations, and third-party integrations. XLIFF translations let you export content, translate it externally, and reimport it into Knak.


Enable XLIFF Translations

You must enable XLIFF translations before you download or upload files.

Steps

  1. Open Admin in your Knak account.

  2. Click Settings.

  3. Scroll to Translations.

  4. Turn on the following options:

    • XLIFF Uploads

    • Use Knak Translations

  5. Select your XLIFF version: 1.2 or 2.0.

    • This setting controls the file format used for downloads.

Translation settings with XLIFF toggles enabled.

Download Your XLIFF File

Download the base asset file before translating.

Steps

  1. Open your asset.

  2. Click the Translate tab.

  3. Click Download Base Asset XLIFF.

Translate tab with the Download Base Asset Xliff option visible.

If you do not see this feature, reach out to Knak Support to enable XLIFF Uploads to your account.


Translate the Base XLIFF File

Use an external translation tool to translate the file into your required languages.
Each language creates a separate XLIFF file.

Important Behavior Notes

Module Variations

  • All module variations are included in the XLIFF file unless the module is globally locked.

  • This includes variations toggled off.

Globally Locked Modules

  • Fully locked modules are not translated. This behavior is intentional.

    • You can tell if a module has been globally locked by the warning "The module has been locked by your administrator" as well as the small lock icon by the module name:

  • Use this method for content like legal footers.

  • Create separate module variations per language when needed.

    Globally locked module with English module variation toggled on.

Links

  • URLs appear only for text elements.

  • URLs do not appear for images or buttons.


Upload XLIFF Files to Knak

Upload each translated file to complete the process.

Steps

  1. Open the Translate tab.

  2. Click Translate Now.

  3. If you have a translation Integration such as Smartling or Transperfect, you will need to select Use Knak Translations to continue. If not proceed to step 4.

    Request translation modal with Use Knak Translations Button.
  4. Choose your source language and translated languages.

  5. Click Next: Sources.

  6. Set the source to Upload XLIFF.

    Request Translation Modal with Upload Xliff selected in source selection page.
  7. Upload or drag the correct file for each language.

  8. Click Next: Confirmation.

  9. Review the summary.

  10. Click Submit Request.

    Successful Xliff upload verifying file content.

Validation Warnings

You see a warning if the file does not match the asset content, or if it does not match the selected language. Upload the correct file to continue.

Validation warning message for uploaded xliff file.

Walkthrough


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?