# How to AI-translate

### How to on a single prodcut

{% hint style="warning" %}
You must be viewing a product to use this.
{% endhint %}

You click the "Enable translation mode" button (<img src="/files/DXX2VYQlZaqfCad7hXok" alt="" data-size="line">), when that is clicked your screen should display similar to this:&#x20;

<figure><img src="/files/BuHshgQ4eJjOnr4dZYXV" alt=""><figcaption><p>The translation page.</p></figcaption></figure>

Now choose your target(s), You can then translate a single attribute by clicking its "Translate" icon (<img src="/files/DXX2VYQlZaqfCad7hXok" alt="" data-size="line">), or translate all attributes by clicking the product’s "Auto Translate All Attribute Values" icon (<img src="/files/DXX2VYQlZaqfCad7hXok" alt="" data-size="line">).

When you use the auto translate feature, the result should look similar to this example:

<div><figure><img src="/files/XEAb1Iiim9NAJmXGhSSj" alt=""><figcaption><p>Select "Translate All Values"</p></figcaption></figure> <figure><img src="/files/ZaI04no7W2AkYb0FLLFo" alt=""><figcaption><p>Result after translation</p></figcaption></figure></div>

### How to on multiple products

{% hint style="warning" %}
To use this, you must be in a category that contains products.
{% endhint %}

Selects the chosen products you want to translate, click the three dots, and then click "Translate data".

<figure><img src="/files/7qabfDG1UavN8nofPAgb" alt=""><figcaption><p>Where to be and click to translate multiple products.</p></figcaption></figure>

This opens a chat with the AI Assistant, which will ask a series of questions. You respond using the predefined answers provided. Follow the chat to complete the translation.

### Example of AI-translation chat

It first ask if you want to choose the fields yourself to translate, or it should translate them all.\
Here i chose to select them myself, then selected the fields and press "Done"**.**&#x20;

<figure><img src="/files/kU4r1Kr0UzQZI3KtKCcL" alt=""><figcaption><p>Selecting product fields for translation in the AI assistant chat.</p></figcaption></figure>

It asks which language you want to translate from; I chose English.\
Next, it asks which language you want the fields translated to, and waits for you to click "Done".

<figure><img src="/files/aanKkHLm9J4IR7IZi1nO" alt=""><figcaption><p>Choosing source language and target languages for translation.</p></figcaption></figure>

It asks whether you want to translate all fields (including those with existing content) or only translate empty fields.

<figure><img src="/files/6czEh3sSsyMO0UeDwY4d" alt=""><figcaption><p>Confirming translation scope for all selected fields and languages</p></figcaption></figure>

It then asks whether you want to approve the changes before saving or save them immediately.

<figure><img src="/files/4TjtS5C5ZH2V1aPymg2V" alt=""><figcaption><p>Selecting whether to approve translations manually or save automatically.</p></figcaption></figure>

After the translation is complete, you can view a report either by navigating to the [Background Tasks](/reference/settings/maintenance/background-tasks.md) or by clicking "Go to Report".\
The AI runs this process as a background task, so you do not need to wait for it to finish.

<figure><img src="/files/JtMbuuu8Q5oFvfAQ1Ibf" alt=""><figcaption><p>Providing a direct link to the translation report.</p></figcaption></figure>

If you chose to save immediately, all results will be approved automatically.\
In this example, I selected the option to approve the results before saving.

<figure><img src="/files/NIeekUmnWRUPxbA9x0ki" alt=""><figcaption><p>Reviewing, approving, or editing translations in the report view.</p></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.struct.com/tutorials/guides/how-to-use-ai-translate/how-to-ai-translate.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
