---
title: "AI-assisted item translation"
slug: "ai-assisted-item-translation"
abstract: "Use the Translation Assistant to translate your items to different language versions using AI."
---
# AI-assisted item translation

The AI-assisted translation feature in the Experience Platform helps you localize content more efficiently by guiding you through translating text defined within a Sitecore item into different languages.

With the **Item Translation Assistant**, you can create or update language versions of items directly in the [Content Editor](https://doc.sitecore.com/xp/en/users/102/sitecore-experience-platform/the-content-editor.html "The Content Editor").

This feature supports translation of text in single-line, multiple-line, rich-text fields, general link, and image fields. It does not support shared or standard fields.

You can use AI to translate an item in two ways:

- [Add and translate a new language version](https://doc.sitecore.com/xp/en/users/102/sitecore-experience-platform/ai-assisted-item-translation.html#UUID-0a652a44-f928-762d-249d-ac7755831935_section-idm234966556569577 "Add and translate a new language version")
- [Translate an existing language version](https://doc.sitecore.com/xp/en/users/102/sitecore-experience-platform/ai-assisted-item-translation.html#UUID-0a652a44-f928-762d-249d-ac7755831935_section-idm1703496656691260 "Translate an existing language version")

> [!note]
> **Before you begin**
> You must have a `sitecore\Sitecore AiClient Item Translation Assistant` role to use this feature. If you don't have this role, ask an administrator to assign it. See [Add or remove AI roles for a user](https://doc.sitecore.com/xp/en/users/102/sitecore-experience-platform/add-or-remove-ai-roles-for-a-user.html "Add or remove AI roles for a user").

## Add and translate a new language version

Use this procedure to create a new language version of an item and translate it with AI.

To translate an item:

1. In the Content Editor, open the item you want to translate.
2. Go to the **Versions** tab, click **Stream Translate**, and then select **Translate item**.
    ![Click Stream Translate > Translate item to initiate translation of the selected language version.](https://doc.sitecore.com/api/markdown-image/xp/en/users/102/sitecore-experience-platform/images/102104-ai-assisted-translation-1.png)
3. In the **Item Translation Assistant** dialog, specify the translation settings:
   - **Brand Kit** - optionally, select a [brand kit](https://doc.sitecore.com/stream/en/users/sitecore-stream/en/brand-kits.html) (only for Sitecore Premium users) to [apply your brand rules and guidelines and protect specific terms](https://doc.sitecore.com/xp/en/users/102/sitecore-experience-platform/ai-assisted-item-translation.html#UUID-0a652a44-f928-762d-249d-ac7755831935_section-id23517752664605).
   - **Source language**- by default, displays the default language. You can select a different language if there are other language versions.
   - **Target language** - select the language you want to translate the content into. By default, this displays the language currently selected in the **Language** dropdown in the [content area](https://doc.sitecore.com/xp/en/users/104/sitecore-experience-platform/the-content-editor.html#the-content-area).

        ![Select all fields or specific fields to translate into the target language.](https://doc.sitecore.com/api/markdown-image/xp/en/users/102/sitecore-experience-platform/images/ai-item-translation-dialog.png)

        > [!note]
        > - The target language must be different from the source language.
        > - If your preferred target language isn't available in the list, you must first add it to the [system settings](https://doc.sitecore.com/xp/en/users/105/sitecore-experience-platform/add-a-new-language-to-system-settings.html).

4. Under **Fields to translate**,  all supported fields are shown by default. Select the fields you want to translate from the **Available fields** list by doing any of the following:
    - To translate specific fields only, double-click the fields or click :mdiChevronRight: to move them to **Selected fields**. 
    - To translate all fields, click **Select all**.
  
    > [!important]
    > Only the fields you move under Selected Fields will be translated.

5. Click **Translate** to begin translation. Stream might take a few minutes to complete the process.

    When finished, the translated content is saved as a new version, with the selected fields translated into the target language.

    > [!note]
    > The item is saved automatically after translation is completed.

6. Review the translation and compare it with the original item or other versions. You can make changes as needed.
   ![Review and compare language versions in the Content Editor by clicking Translate.](https://doc.sitecore.com/api/markdown-image/xp/en/users/102/sitecore-experience-platform/images/XP_Translate_Compare_Stream_Translate.png)

    > [!important]
    > AI-generated translations might not always be accurate. Review all translated text before using or publishing it. AI outputs can vary between attempts, so translating the same thing more than once can produce different results.


## Translate an existing language version

Use this procedure to retranslate an item and update any of its existing language versions.

To translate an existing language version:

1. In the Content Editor, open the item you want to translate.
2. Go to the **Versions** tab, click **Stream Translate**, and then select **Translate item**.

    ![Click Stream Translate > Translate item to initiate translation of the selected language version.](https://doc.sitecore.com/api/markdown-image/xp/en/users/102/sitecore-experience-platform/images/XP_Retranslate_Stream_Translate.png)

3. In the **Item Translation Assistant** dialog, specify the translation settings:
   - **Brand Kit** - optionally, select a [brand kit](https://doc.sitecore.com/stream/en/users/sitecore-stream/en/brand-kits.html) (only for Sitecore Premium users) to [apply your brand rules and guidelines and protect specific terms](https://doc.sitecore.com/xp/en/users/102/sitecore-experience-platform/ai-assisted-item-translation.html#UUID-0a652a44-f928-762d-249d-ac7755831935_section-id23517752664605).
   - **Source language**- by default, displays the default language. You can select a different language if there are other language versions.
   - **Target language** - select the language you want to translate the content into. By default, this displays the language currently selected in the **Language** dropdown in the [content area](https://doc.sitecore.com/xp/en/users/104/sitecore-experience-platform/the-content-editor.html#the-content-area).
    ![Select all fields or specific fields of the item to translate. Fields with values are marked with an asterisk (*).](https://doc.sitecore.com/api/markdown-image/xp/en/users/102/sitecore-experience-platform/images/ai-item-translation-dialog-retranslate.png)
       
     > [!note]
     > - The target language must be different from the source language.
     > - If your preferred target language isn't available in the list, you must first add it to the [system settings](https://doc.sitecore.com/xp/en/users/105/sitecore-experience-platform/add-a-new-language-to-system-settings.html).

4. Under **Fields to translate**,  only empty, supported fields are shown by default. Select the fields you want to translate from the **Available fields** list by doing any of the following:

    - To include supported fields that already have values, select the **Include fields with values** check box. Fields with values are marked with an asterisk (*).
    - To translate specific fields only, double-click the fields or click :mdiChevronRight: to move them to **Selected fields**.
    - To translate all fields, click **Select all**.
  
    > [!important]
    > Only the fields you move under Selected Fields will be translated.

5. Click **Translate** to begin translation. If the selected fields have existing values, a warning appears. If you click **OK**, Stream will overwrite those values with the translated content in the same language version.

    Translation might take a few minutes. When finished, the translated content is saved to the selected fields in the same language version.

    > [!note]
    > The item is saved automatically after translation is completed.

6. Review the updated translation and compare it with the original item or other versions. You can make changes as needed.
    ![Review and compare language versions in the Content Editor by clicking Translate.](https://doc.sitecore.com/api/markdown-image/xp/en/users/102/sitecore-experience-platform/images/XP_Translate_Compare_Stream_Translate.png)
    > [!important]
    > AI-generated translations might not always be accurate. Review all translated text before using or publishing it. AI outputs can vary between attempts, so translating the same thing more than once can produce different results.

   
## Using brand kits for translation

When you select a brand kit, the **Item Translation Assistant** applies your brand’s rules and guidelines to help maintain brand voice and protect key terminology during translation.

To prevent product names, trademarks, or other terms from being translated, add protection rules in the brand kit’s **Do's and Don'ts** section.

Example rule for protected terms `Term1` and `Term2`:

*“When translating, if you encounter the following quoted phrases or words: "`Term1`", "`Term2`" do not translate them but translate the rest of the text.”*

Best practices for brand kit rules:

- **Be specific** - write clear, detailed rules for better execution.
- **Use quoted phrases** - identify protected terms with quotation marks.
- **Test your rules** - validate them with sample content before bulk use.
- **Maintain consistency** - align rules with brand guidelines.
- **Update regularly** - refresh rules as new products or terms are introduced.

> [!important]
> Manually added term protection rules in a brand kit’s [Do's and Dont's](https://doc.sitecore.com/stream/en/users/sitecore-stream/brand-kits.html#understanding-the-brand-kit-sections) section might be overwritten or lost when knowledge sources are reprocessed unless the section is marked as [Non AI-editable](https://doc.sitecore.com/stream/en/users/sitecore-stream/review-or-refine-a-brand-kit-section.html#make-a-brand-kit-section-non-ai-editable). See also [using terminology rules](https://doc.sitecore.com/stream/en/users/sitecore-stream/guidelines-for-do-s-and-don-ts-in-brand-kits.html#using-terminology-rules-for-translation) for additional guidance.

## Troubleshooting

This section helps you identify and fix common issues when using the **Item Translation Assistant**.

Stream Translate option not visible

If the **Stream Translate** button does not appear on the **Versions** tab ribbon:

- Verify that the **Translation** group is visible on the **Versions** tab. If it is not, you do not have the required `Sitecore Client Translating` standard role.