What Is Single-File Translation Sync?
Single-File Translation Sync lets you combine multiple translated emails into one asset in Salesforce Marketing Cloud (SFMC).
You no longer manage separate emails for each language. You send one email that dynamically displays the correct version.
Set Up Single-File Email Sync
Enable this feature in your Marketing Cloud integration settings.
Steps
Go to Admin > Integrations > Platforms
Find your Marketing Cloud integration
Click Edit Connection
Open Advanced Options
Enable Sync translation variants as one email
Enter your language variable
Example:
languageorlocale
Optional: Restrict variant-only syncs when single file sync is enabled
Click Save Changes.
Note: If this option is not visible, contact your Customer Success Manager (CSM) or Knak Support.
Use Single-File Email Sync
Use this feature when your email includes translations.
Steps
Create your base email in Knak
Create translated versions using
Knak AI and manual translations
From your base email, click Actions menu > Sync
Choose your Marketing Cloud integration
Select a destination folder
Enter an email name (if needed)
Click Confirm and sync
What Happens in Marketing Cloud?
After syncing, several assets are created.
Main Email Asset
Contains AMPscript (a scripting language in SFMC)
Displays the correct language automatically
Variants Folder
A folder with your email name + “variants”
Stores each language version
Tip: If the folder is not visible, enable Show Folders in SFMC.
Content Blocks
Each language includes:
HTML content
Plain text content
Subject line
Preview text
The system selects the correct version using the language variable.
What Happens on Resync?
When you resync your email, Knak updates all related assets in Marketing Cloud.
Key Behaviors
All content blocks are recreated
Any edits made directly in Marketing Cloud are overwritten
The main email updates with the latest AMPscript
How Content Blocks Work
Each sync creates new content blocks inside your variants folder. Older blocks may remain in the folder after multiple syncs.
Only the content blocks referenced in the main email are used. Other blocks are not active.
Identify the Active Content Block
Follow these steps to confirm which content block is currently in use:
Open Content Builder in Marketing Cloud
Open your main email asset
Click the Plain Text tab
Locate the AMPscript block for that language variant
Example:
%%=ContentBlockById(123456789)=%%
Copy the ID number inside the parentheses
Open your variants folder
Sort content blocks by Date Modified (newest first)
Open the most recent plain text block
Check the ID in the details section
If the ID matches, that block is active. Any other content blocks in the folder are unused. You can ignore them.
Preview Your Email
Check how each language appears before sending.
Steps
Open your email in Marketing Cloud
Click Preview and Test
Select test users with different language settings
Best Practices
Complete all translations before syncing
Match the language variable with your SFMC setup
Preview every language version after sync
Need more help? Contact support via live chat using the chat bubble in the bottom right corner or email support@knak.com.