---
title: Translating content using external services
related:
- https://docs.kentico.com/13/multilingual-websites/editing-the-content-of-multilingual-websites.md
- https://docs.kentico.com/13/multilingual-websites/setting-up-multilingual-websites.md
- https://docs.kentico.com/13/multilingual-websites/configuring-translation-services.md
- https://docs.kentico.com/13/multilingual-websites/developing-custom-translation-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).
You can automate or outsource the translation of website content using translation services. The system automatically ensures the transfer of data between the website's pages and translation providers. Translation data is exported and imported via files using the standard XML-based [XLIFF](http://en.wikipedia.org/wiki/XLIFF) format.
> **Info:** **Supported content**
>
> Translation services can process the following types of page content:
>
> - Values of page fields on the **Content** tab of the _Pages_ application
> - Page file attachments
>
> Text added and displayed through [page builder widgets](https://docs.kentico.com/13/managing-website-content/adding-page-content-using-widgets.md) is NOT processed by translation services or included in the resulting translation data.
>
> For more information, see: [Configuring content for translation](https://docs.kentico.com/13/multilingual-websites/configuring-translation-services/configuring-content-for-translation.md)
There are two general categories of translation services:
- **Machine services** – use translation software to programmatically convert source text from one language to another. By default, Xperience supports [Microsoft Translator](https://docs.microsoft.com/en-us/azure/cognitive-services/translator/) and [Google Translator](https://cloud.google.com/translate/docs/).
- **Standard services (human translation)** – provide an automated interface between the system and external human translators. By default, Xperience supports Email translation and Manual translation.
The main purpose of translation services is to create language versions of the website's pages based on the content in another language. There are several different ways to submit pages for translation.
> **Tip:** You can integrate page translation via services into your [workflow](https://docs.kentico.com/13/configuring-xperience/configuring-the-environment-for-content-editors/configuring-workflows.md) process. Advanced workflow offers action steps that allow you to [automatically manage page translations](https://docs.kentico.com/13/configuring-xperience/configuring-the-environment-for-content-editors/configuring-workflows/designing-advanced-workflows/adding-action-steps-in-advanced-workflows.md#managing-page-translations-within-workflow).
>
> There are two predefined workflows (in the **Workflows** application) that you can configure and apply to your website:
>
> - **Translation - Default language version** – automatically sends pages for translation via a selected service when a user approves the default language version.
> - **Translation - Import to other language versions** – periodically checks for translations completed by standard services and imports them into the appropriate pages when ready.
## Requirements
- The **Enable translation services** setting must be enabled in **Settings -> Content -> Translation services**.
- The chosen type of translation service must be configured in **Settings -> Content -> Translation services**. See [Configuring translation services](https://docs.kentico.com/13/multilingual-websites/configuring-translation-services.md).
- Your website needs to be [configured for multiple content cultures](https://docs.kentico.com/13/multilingual-websites/setting-up-multilingual-websites.md), including all languages that you plan to use.
## Translating pages to other languages
You can create new language versions of pages using a translation service in:
- [The Pages application](#translating-pages-in-the-pages-application)
- [The Translations application](#creating-submissions-in-the-translations-application) – use this if you want to submit page translations and view the status of ongoing translation submissions in the same interface. Only applies to **standard services** (Manual translation, Email translation).
- [Page listing](#translating-multiple-pages) – allows you to submit multiple pages for translation in a single operation.
### Translating pages in the Pages application
1. Open the **Pages** application.
2. Select the page that you wish to translate in the content tree.
3. Switch to the target language using the selector below the content tree.
4. Select **Translate using translation service**.
5. Choose one of the available translation services. If you cannot see the desired option:
1. Make sure the configuration is correct in **Settings -> Content -> Translation services**. See [Configuring translation services](https://docs.kentico.com/13/multilingual-websites/configuring-translation-services.md) for details on configuring translation services.
2. ([Translation.com](http://Translation.com), Microsoft Translator, and Google Translator service) Check the **Event log** application for incorrect credentials errors.
6. Fill in the details for the translation (some of the options may not be supported by the selected service):
| Translate from | If the page already exists in more than one language, you can choose which one the service uses as the source for the translation. |
| ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Human translation parameters | |
| Translate attached files | Enable this option to submit the page's file attachments for translation along with the main content.
The system adds file attachments directly into the [XLIFF](http://en.wikipedia.org/wiki/XLIFF) translation source as binary data encoded in Base64 format.
Note that [image variants](https://docs.kentico.com/13/developing-websites/managing-responsive-images.md) of file attachments are not included in the XLIFF translation source. |
| Priority | Sets the priority of the translation (low, normal or high). |
| Translation deadline | Specifies a deadline date for the translation. |
| Instructions for translators | Here you can enter additional instructions for human translators. |
7. Click **Submit for translation**.
The system adds the new language version of the page.
- Machine services immediately insert the translated content into the new page version.
- When using standard (human) translation services, the system initially creates the new page version as a copy of the source language. The content tree shows the _Waiting for translation_ status icon () next to pages in this state. You can manage the translation through a submission ticket in the **Translations** application. Once the service completes the translation, you can process the submission to transfer the new content into the appropriate language version of the page.
### Creating submissions in the Translations application
> **Note:** You cannot use machine translation services (Google Translate or Microsoft Translator) in the submissions dialog. Translate pages using machine translation services directly in the **Pages** application.
1. Open the **Translations** application.
2. Click **Create new submission**.
3. **Select** the page that you want to translate. You can also type the path directly in the field.
4. Choose one of the available translation services.
1. Make sure the configuration is correct in **Settings -> Content -> Translation services**. See [Configuring translation services](https://docs.kentico.com/13/multilingual-websites/configuring-translation-services.md) for details on configuring translation services.
2. (Translation.com service) Check the **Event log** application for incorrect credentials errors.
5. Fill in the details for the translation (some of the options may not be supported by the selected service):
| Translate from | If the page already exists in more than one language, you can choose which one the service uses as the source for the translation. |
| ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Translate to | Select the target languages of the translation. |
| Human translation parameters | |
| Translate attached files | Enable this option to submit the page's file attachments for translation along with the main content.
The system adds file attachments directly into the [XLIFF](http://en.wikipedia.org/wiki/XLIFF) translation source as binary data encoded in Base64 format.
Note that [image variants](https://docs.kentico.com/13/developing-websites/managing-responsive-images.md) of file attachments are not included in the XLIFF translation source. |
| Priority | Sets the priority of the translation (low, normal or high). |
| Translation deadline | Specifies a deadline date for the translation. |
| Instructions for translators | Here you can enter additional instructions for human translators. |
6. Click **Translate**.
The system adds the new language version of the page. The system initially creates the new page version as a copy of the source language. Once the service completes the translation, you can process the submission to transfer the new content into the appropriate language version of the page. The content tree shows the _Waiting for translation_ status icon () next to pages in this state.
### Translating multiple pages
To translate more than one page using a single action:
1. Open the **Pages** application.
2. Switch to **Listing** mode.
3. Select the _parent_ of the pages that you wish to translate in the content tree.
4. Switch to the target language using the selector below the content tree.
5. Mark pages for translation using the check boxes next to the listed items.
6. Select the **Translate** action below the page list.
7. Click **OK**.
8. Choose a service and specify the parameters of the translation.
- Make sure the configuration is correct in **Settings -> Content -> Translation services**. See [Configuring translation services](https://docs.kentico.com/13/multilingual-websites/configuring-translation-services.md) for details on configuring translation services.
- (Translation.com service) Check the **Event log** application for incorrect credentials errors.
9. When submitting multiple pages for translation, you can also enable or disable the following options:
| Skip already translated pages | If checked, pages that already exist in the target language are not submitted for translation.
Disable this option to overwrite the current content of the pages with the text returned by the translation service. |
| ------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Send all pages within one submission | If enabled, the system includes all listed pages in a single translation submission. Otherwise, separate submissions are created for individual pages. Only applicable when using a human translation service. |
10. Click **Translate**.
The translation process works the same way as for single items, but the system performs it for all selected pages.
## Resubmitting pages sent for translation
The system allows you to resubmit pages already sent for translation (for example, if you edited the page and want to translate the modified version instead).
You can resubmit pages for translation in:
- [The Pages application](#resubmitting-translations-in-the-pages-application)
- [The Translations application](#resubmitting-translations-in-the-translations-application) (standard translation services only)
### Resubmitting translations in the Pages application
1. Open the **Pages** application.
2. Select the modified page in the content tree.
3. Open the **Properties -> Languages** tab.
4. Click the **Translate page** () action for the language version that you wish to re-submit.
5. Choose a service and specify the parameters of the translation.
6. Click **Translate**.
The system submits the page for translation just like when creating a new language version. The text returned by the translation service overwrites the original content of the page in the selected language.
### Resubmitting translations in the Translations application
1. Open the **Translations** application.
2. (Optional) If you want to edit the submission before resubmitting it, click **Edit** () and change the details.
3. If you edited the submission, click **Save and Resubmit**. Otherwise click **Resubmit** () in the list of translation submissions.
The system submits the edited page for translation. The new submission replaces the previous one in the submissions list.
## Re-translating existing page versions
You can submit pages for translation even if they already exist in the target language. This allows you to use translation services to update the language versions of a page after making changes to its main content.
1. In the **Pages** application, select the page in the content tree.
2. Open the **Properties -> Languages** tab.
3. Click the **Translate page** () action for the language version that you wish to re-translate.
4. Choose a service and specify the parameters of the translation.
5. Click **Translate**.
The system submits the page for translation just like when creating a new language version. The text returned by the translation service overwrites the original content of the page in the selected language.
> **Info:** You may also use the **Properties -> Languages** tab to create new language versions of pages (even if the given page does not exist in the target language).