# Widget localization

{% hint style="info" %}
This feature is currently part of an Early Adopters program. General availability by January 2026.
{% endhint %}

## Prerequisite

To enable localization, ensure your account has multiple tags thanks to the Tag Sharding feature. Contact your Customer Success Manager (CSM) to activate this feature.

{% hint style="info" %}
This feature is not applicable in the Code Widgets.&#x20;
{% endhint %}

## 1. Localized Widget Campaign Setup

{% stepper %}
{% step %}
Create a new campaign.

[If you need more information about campaign creation, read our dedicated article](/web-experimentation-and-personalization/campaign-creation-and-dashboard/how-to-create-a-campaign.md).
{% endstep %}

{% step %}
In the Main information page > **Options** panel, toggle on the **Campaign localization** option
{% endstep %}

{% step %}
In the **Sample URL to load in the editor** field, enter the URL of a page in one of your chosen languages.

> Example : "<https://mywebsite.com>"
> {% endstep %}

{% step %}
Choose the target languages:

1. Open the drop-down menu.
2. Select all languages you want to support in your campaign.

<div data-with-frame="true"><figure><img src="/files/iD3fJNMQlPiygSli3un6" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Click on **Save & Go to the next step** to access the editor.

* The Preview localization button (language flag) appears at the top of the editor.

<div data-with-frame="true"><figure><img src="/files/68uBjz1jvWCUdk56KDKa" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Add and configure a widget

* Insert a widget into the page.
* Configure the widget content in the primary language

[If you need more information about widgets configuration, read our dedicated article](/web-experimentation-and-personalization/editors-and-widget/list-of-widgets/widgets-configuration-in-the-visual-editor.md).
{% endstep %}

{% step %}
Open the Localization interface

1. In the Editor action bar, click on the **Translations** button.

<div data-full-width="true" data-with-frame="true"><figure><img src="/files/aclc3CWWpTV4UbdkoWTl" alt="" width="75"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
In the translation windows, enter the translated content for each selected language.

<div data-with-frame="true"><figure><img src="/files/RhMdLCQFuJBeC65knGCb" alt="" width="563"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Click on **Save changes**.&#x20;

The widget content is now available in all selected languages.
{% endstep %}
{% endstepper %}

## 2. Preview and verify translations

{% stepper %}
{% step %}
On the top of the editor, click on the **Preview** button (Flag).
{% endstep %}

{% step %}
Select the language you want to preview. A confirmation box opens.
{% endstep %}

{% step %}
{% hint style="info" %}
Only the widget content is translated in the preview; the underlying page remains in the original language.
{% endhint %}

Click **OK** to open the preview. Your widget appears in the selected target language.
{% endstep %}

{% step %}
Review each translation to ensure accuracy.
{% endstep %}

{% step %}
If you spot an issue,&#x20;

1. In the Editor action bar, click on the **Translations** button.
2. Fix the target text.
3. Click on **Save changes**.
   {% endstep %}
   {% endstepper %}

## 3. Set up targeting for all languages

In the targeting phase, in the Page(s) block, enter the URLs for every page and language you want to target.&#x20;

> Example:&#x20;
>
> Enter condition "is <https://mywebsite.com>" for your source website
>
> Enter condition "is <https://mywebsite.com/fr>" for French version of your website
>
> Enter condition "is <https://mywebsite.com/se>" for swedish version of your website

This ensures the localized widget displays on the correct pages for each language.

[If you need more information about the targeting step, read our dedicated article.](/web-experimentation-and-personalization/targeting-step.md)

## Result

Your campaign now includes a widget that displays localized content based on the visitor’s language.


---

# 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.abtasty.com/web-experimentation-and-personalization/editors-and-widget/widget-localization.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.
