# Import / Export Option Set Translations

The **Import/Export Option Sets’ Translation** feature allows you to manage translated option labels and content in bulk using CSV files.\
This is especially useful if you sell in multiple languages or want to quickly update translations without editing each option manually in the app.

***

## Export Translations

#### 1. Go to the **Avis Option** page and select the option sets you want to export.

<figure><img src="/files/H8iK1GMheKElRVQ1bGF9" alt=""><figcaption></figcaption></figure>

Click **Export → Translation**.

#### 2. Choose the export range:

* All option sets on the current page
* All option sets in the store
* Only selected sets

#### 3. Select language and Click **Export** again to download the CSV file.

<figure><img src="/files/esuPY0cRpXWTKFwnN953" alt=""><figcaption></figcaption></figure>

You will receive a CSV file containing all the option sets with their translation fields. This file can be shared with translators or modified directly.

***

### Import Translations

#### 1. Navigate to the **Avis Option** page and select **Import → Translation**.

<figure><img src="/files/et9iIvXmtYdwYlDASnm1" alt=""><figcaption></figcaption></figure>

#### 2. Choose Add file and then Select your CSV file containing the updated translations.

<figure><img src="/files/X9jgsUIN6nVvq75J7tbN" alt=""><figcaption></figcaption></figure>

#### 3. Click **Open** to upload the file, then click **Upload** to import it into option sets.

<figure><img src="/files/O4frO11IY8CMWRvRSGjq" alt=""><figcaption></figcaption></figure>

Review the imported data, then click **Save** so the translations will apply across your storefront.

***

### CSV Translation Fields

When exporting or importing translations, the CSV will include special fields for localized content, in addition to the core option fields.

This is a German translation example. The language should change according to your selection during import/export.

<table><thead><tr><th width="215">Field</th><th width="78.00009155273438">Type</th><th>Description</th></tr></thead><tbody><tr><td>no. - German</td><td>Number</td><td>Sequence number for easier reference. Not required to edit.</td></tr><tr><td>row_type</td><td>Text</td><td>Defines whether the row is an <code>option_set</code> or an <code>option</code>. System field – do not edit.</td></tr><tr><td>Locale id</td><td>String (UUID)</td><td>Locale identifier. Auto-generated by system – do not edit.</td></tr><tr><td>Option set id</td><td>String (UUID)</td><td>Unique ID of the option set. Auto-generated – do not edit.</td></tr><tr><td>Option set name</td><td>Text</td><td>The name of the option set. Auto-generated – do not edit.</td></tr><tr><td>Option key</td><td>String</td><td>Unique key of the option. Auto-generated – do not edit.</td></tr><tr><td>Value id</td><td>String (UUID)</td><td>ID for specific values in options. Auto-generated – do not edit.</td></tr><tr><td>Automated key</td><td>String</td><td>Used for automated options. System field – do not edit.</td></tr><tr><td>Option type</td><td>Text</td><td>Type of option (e.g., <code>text</code>, <code>font</code>, <code>swatch_multi_image</code>). System field – do not edit.</td></tr><tr><td>Label on product (English - default)</td><td>Text</td><td>Default label shown on the product page (English). Auto-filled – do not edit.</td></tr><tr><td><strong>Label on product (German)</strong></td><td>Text</td><td>The <strong>translation of product label</strong> in German. Customer should fill this.</td></tr><tr><td>Label on cart (English - default)</td><td>Text</td><td>Default label shown in the cart (English). Auto-filled – do not edit.</td></tr><tr><td><strong>Label on cart (German)</strong></td><td>Text</td><td>The <strong>translation of cart label</strong> in German. Customer should fill this.</td></tr><tr><td>Value (English - default)</td><td>Text</td><td>Default option value in English. Auto-filled – do not edit.</td></tr><tr><td><strong>Value (German)</strong></td><td>Text</td><td>The <strong>translation of option value</strong> in German. Customer should fill this.</td></tr><tr><td>Value description (English - default)</td><td>Text</td><td>Default description of the value (English). Auto-filled – do not edit.</td></tr><tr><td><strong>Value description (German)</strong></td><td>Text</td><td>The <strong>translation of the value description</strong> in German. Customer should fill this.</td></tr><tr><td>Placeholder (English - default)</td><td>Text</td><td>Default placeholder text (English). Auto-filled – do not edit.</td></tr><tr><td><strong>Placeholder (German)</strong></td><td>Text</td><td>The <strong>translation of placeholder text</strong> in German. Customer should fill this.</td></tr><tr><td>Help text (English - default)</td><td>Text</td><td>Default help text (English). Auto-filled – do not edit.</td></tr><tr><td><strong>Help text (German)</strong></td><td>Text</td><td>The <strong>translation of help text</strong> in German. Customer should fill this.</td></tr><tr><td>Tooltip text (English - default)</td><td>Text</td><td>Default tooltip text (English). Auto-filled – do not edit.</td></tr><tr><td><strong>Tooltip text (German)</strong></td><td>Text</td><td>The <strong>translation of tooltip text</strong> in German. Customer should fill this.</td></tr><tr><td>Condition field</td><td>Text</td><td>Condition applied to the option. Auto-filled – do not edit.</td></tr><tr><td>Condition type</td><td>Text</td><td>Defines the condition type. Auto-filled – do not edit.</td></tr><tr><td>Condition value (English - default)</td><td>Text</td><td>Default condition value in English. Auto-filled – do not edit.</td></tr><tr><td><strong>Condition value (German)</strong></td><td>Text</td><td>The <strong>translation of condition value</strong> in German. Customer should fill this.</td></tr><tr><td>Automated type</td><td>Text</td><td>Type of automated field. System field – do not edit.</td></tr><tr><td>Keyword compare type</td><td>Text</td><td>Keyword comparison setting. Auto-filled – do not edit.</td></tr><tr><td>Automated value (English - default)</td><td>Text</td><td>Default automated value (English). Auto-filled – do not edit.</td></tr><tr><td><strong>Automated value (German)</strong></td><td>Text</td><td>The <strong>translation of automated value</strong> in German. Customer should fill this.</td></tr></tbody></table>

{% hint style="info" %}
Editable fields are bolded parameters and include: **Product label (German)**, **Cart label (German)**, **Value (German)**, **Value description (German)**, **Placeholder (German)**, **Help text (German)**, **Tooltip text (German)**, **Condition value (German)**, and **Automated value (German)**.
{% endhint %}


---

# 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://options-docs-v2.avisplus.io/building-options/translate-avis-options/import-export-option-set-translations.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.
