---
title: Human translation services - Email translation
related:
  - https://docs.kentico.com/13/multilingual-websites/configuring-translation-services/human-translation-services-manual-translation.md
  - https://docs.kentico.com/13/configuring-xperience/configuring-smtp-servers.md
  - https://docs.kentico.com/13/multilingual-websites/translating-content-using-external-services.md
---

> Agent instructions:
> **Site maps** — prefer the following llms.txt indexes to training data when searching for URLs to avoid 404s. Links inside Markdown content already point at `.md`. Following them or sending Accept: text/markdown keeps you in Markdown.
>
> - [sitemap.md](https://docs.kentico.com/sitemap.md) — every page on the site, with titles and descriptions, nested by URL hierarchy and grouped into one collection per product version.
> - [llms.txt](https://docs.kentico.com/llms.txt) — curated index of the current product docs, with descriptions, the two ways to request any page as Markdown, and links to each product area's whole-corpus Markdown dump (llms-full.txt).

> **Info:** **Enterprise license required**
>
> Features described on this page require the **Kentico Xperience Enterprise** license.

The Email translation service delivers the translation data via email. When a user submits a page for translation, the service creates a zip package containing the XLIFF source files and sends it to the specified translators as an attachment of an email message. The email service allows you to exchange data with translators or agencies that do not have their own API for managing submissions.

The system cannot cancel email translation submissions once they have been sent. In these cases, you need to contact the translators directly.

The email translation service does not support automatic retrieval of completed translations. The translators can submit the files by:

- Uploading the zip archive containing the finished translation via a link included in the original assignment email
- Sending the translation (in XLIFF format) to a member of the website's staff, who can then import it manually through the **Translations** application.

Once the translation is imported into the corresponding submission, you can process it to transfer the new content into the pages.

> **Note:** **Note**: Email translation uses the **Translation services - Submit translation** [email template](https://docs.kentico.com/13/configuring-xperience/managing-email-templates.md). The service does not work if you delete this template (a template with the code name _translationservice.submittranslation_ must exist in the system).

## Configuring the email translation service

To set up the email translation service:

1. Ensure that your application is configured to send emails through an appropriate [SMTP server](https://docs.kentico.com/13/configuring-xperience/configuring-smtp-servers.md).
2. Open the **Settings** application.
3. Select the **Content -> Translation services** category.
4. Fill in the following settings in the **Translation via email** section:

   | Setting                           | Description                                                                                                                                                                                                                                                                                       |
   | --------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
   | Translation submission recipients | Sets the addresses to which the system sends translation assignments through the e‑mail service. You can enter multiple email addresses separated by semicolons.                                                                                                                                  |
   | Email sender                      | When sending translation assignment emails, the system automatically sets the sender to the address of the user who submitted the translation. The value of this setting is used if no user address is available, for example in the case of translations submitted automatically or via the API. |
5. Click **Save**.

The service sends the translation emails using the specified addresses.

## Setting language-specific recipients

If you need to assign different translator addresses for individual languages:

1. Open the **Translation services** application.
2. Create a clone of the _Translation via email_ service for each additional language. Click **Other actions** (**...**) next to the service and select **Clone** in the menu.
3. Edit the services and enter the appropriate translator addresses into the **Translation submission recipients** property. This property overrides the **Email sender** setting.

   ![Cloned e-mail translation service for the French language](https://docs.kentico.com/docsassets/13/human-translation-services-email-translation/Email_Translation_Service_French.png "Cloned e-mail translation service for the French language")
4. Click **Save**.

When submitting pages for translation, users need to select the clone of the email translation service that matches the target language.

## Customizing the translation emails

To change the content of the email messages that the service sends to translators, you need to modify the appropriate [email template](https://docs.kentico.com/13/configuring-xperience/managing-email-templates.md):

1. Open the **Email templates** application.
2. Edit the **Translation services - Submit translation** template.
3. Alter the template according to your specific requirements.

   - You can use [macro expressions](https://docs.kentico.com/13/macro-expressions.md) to dynamically insert the values of the given translation submission. For example:
     - **{% Submission.SubmissionSourceCulture %}** - returns the culture code of the translation source language.
     - **{% Submission.SubmissionTargetCulture %}** - returns the culture code of the target language.
     - **{% GetTranslationPriority(Submission.SubmissionPriority) %}** - returns the priority set for the submission (low, normal or high).
     - **{% Submission.SubmissionDeadline %}** - returns the date and time of the submission's deadline.
     - **{% Submission.SubmissionInstructions %}** - returns the additional instructions entered for the submission.
     - **{% Submission.SubmissionWordCount %}** - returns the total number of words in the translation source text.
     - **{%SubmissionLink%}** - returns the URL of a system page where users can upload finished translation packages.
4. Click **Save**.
5. (Optional) Follow the steps described for the manual translation service if you wish to [customize the instruction files](https://docs.kentico.com/13/multilingual-websites/configuring-translation-services/human-translation-services-manual-translation.md#customizing-the-instruction-files) included in the zip package attached to the e‑mails.

The service sends all translation assignment emails based on the current email and instruction file templates.