---
title: Configuring content for translation
related:
  - https://docs.kentico.com/k82/multilingual-websites/setting-up-multilingual-websites.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:** **Kentico EMS required**
>
> Features described on this page require the **Kentico EMS** license.

Translation services can process the following types of page content:

- Content of editable regions
- Values of page fields (entered on the **Form** tab of the Pages application)
- The properties of web parts placed on the given page
- Page file attachments

The system allows you to specify exactly which parts of the content are translated. These settings affect all types of translation services.

## Configuring page fields

To choose which page fields are sent for translation, adjust the form definition of individual [page types](https://docs.kentico.com/k82/developing-websites/defining-website-data-structure/page-types.md):

1. Open the **Page types** application.
2. Edit () a specific page type.
3. Switch to the **Fields** tab.
4. Select the field that you wish to configure and enable or disable the **Translate field** flag. Translation is only available for fields with the _Text_, _Long text_ or _File_ **Data type**.
5. Click **Save** to confirm the changes to the field.

![Enabling the Translate field flag for a page type field](https://docs.kentico.com/docsassets/k82/configuring-content-for-translation/DocTypes_Translate_Field.png "Enabling the Translate field flag for a page type field")

When users submit pages of the given type for translation, only the content of fields that have the **Translate field** flag enabled is included in the translation.

## Configuring web part content

Pages may also contain text added via [Web parts](https://docs.kentico.com/k82/developing-websites/developing-websites-using-the-portal-engine/using-and-configuring-web-parts.md) and [Widgets](https://docs.kentico.com/k82/managing-website-content/adding-page-content-through-widgets.md). The only way to translate web part content is to localize the values of the corresponding web part properties. You can configure the system to automatically include specific web part properties in translations. This is only recommended for web parts that directly add text onto the page (such as **Static text**).

1. Open the **Settings** application and select the **Content -> Translation services** category.
2. Enable the **Translate web part properties** setting.
3. Click **Save.**
4. Open the **Localization** application and select **Cultures** tab.
5. Enable the **Is UI culture** flag for all content languages that you use on your website (see [Setting up a multilingual user interface](https://docs.kentico.com/k82/multilingual-websites/setting-up-a-multilingual-user-interface.md)).
6. Open the **Web parts** application.
7. Select the appropriate web part and open the **Properties** tab.
8. Enable or disable the **Translate field** flag for individual properties.

   - Translation is only available for properties that use the _Text_, _Long text_ or _File_ **Attribute type**.
   - Click **Save** for every modified property.

If a page that contains the given web part is submitted for translation, the system includes the values of all properties that have the **Translate field** flag enabled. When importing the translation, the system creates a [resource string](https://docs.kentico.com/k82/multilingual-websites/setting-up-a-multilingual-user-interface/working-with-resource-strings.md) for every translated property, containing the value in the target language. The original text values of the properties are replaced by [localization macros](https://docs.kentico.com/k82/multilingual-websites/setting-up-a-multilingual-user-interface/localizing-text-fields.md), which insert the appropriate resource strings.

> **Note:** **Editable text regions**
>
> Translation submissions always include the page content entered by users into **Editable text** web parts, regardless of the web part translation settings.

## Allowing translation of page attachments

Human translation services allow users to submit [file attachments](https://docs.kentico.com/k82/managing-website-content/working-with-files/page-attachments/attaching-files-to-pages.md) for translation along with the main content of pages. To configure attachment translation for your website:

1. Open the **Settings** application and select the **Content -> Translation services** category.
2. Enable the **Allow attachment translation** setting.
3. Specify which types of files should be translated using the **Translation attachments file types** setting.

   - Enter a list of all allowed file extensions separated by semicolons (for example: _txt;docx;pdf_). Leave the setting empty to allow translation for all types of attached files.
4. Click **Save**.

Users can check the **Translate attached files** option when [submitting pages for translation](https://docs.kentico.com/k82/multilingual-websites/translating-content-using-external-services.md), and the system adds all allowed file attachments into the translation source. When the completed translation is imported, the translated file is attached to the appropriate language version of the page.

> **Note:** **File format**
>
> The system adds file attachments directly into the XLIFF translation source as binary data encoded in Base64 format.