> This page is for Product.

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.makeswift.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.makeswift.com/_mcp/server.

# AI Translations

> Use AI to automatically translate your site content into one or more locales.

Use AI to automatically translate your site content into one or more locales.

> **Info**
>
> AI Translations is currently a beta feature only available on paid plans. You'll need to opt-in to enable it for your account under **Settings** > **Early access**.

AI Translations lets you generate translations for pages and components across your Makeswift site without leaving the builder. You can define custom instructions to guide the AI—such as terms to leave untranslated—and then select exactly which content and locales to translate.

> **Warning**
>
> AI translations overwrite existing content in the chosen locales and cannot be automatically undone. Review translations carefully before publishing.

## Add AI translation instructions

Before requesting a translation, you can define global instructions that apply every time the AI translates your content. For example, you might tell the AI not to translate brand names or product-specific terms.

#### Open Localization settings

In the left sidebar, navigate to **Settings** > **Localization**.

![Localization settings panel showing the AI translations section](/_fern-img/9a2953d0d09b5aee8231b18a4d977eaee07d4743d716ac9703bd770a63470009.webp)

#### Enter your instructions

Enter any rules you want the AI to follow in the text field within the **AI Translations** section. For example: *Don't translate the company name or product names.*

#### Save

Click **Save**. Your instructions are applied to all future translation requests for this site.

## Request a translation

#### Open the translation dialog

You can access the translation dialog from the **Localization** settings panel by clicking **Translate site**.

![Localization settings showing button to open the translation dialog](/_fern-img/f656670356dbe00cfb1c70fafa3fed93e392ca4e9a8a09ce416f23346187a907.webp)

Or from the locale menu when a locale is selected.

![Locale menu showing button to open the translation dialog](/_fern-img/a6b9e5d346d953e3ccaf30890140f6287595b2b41be9a9114dae605bbdae20dc.webp)

#### Select locales and content

The translation dialog opens on the **Site** tab. Choose which locales to translate into using the checkboxes on the left. On the right, select the components and pages whose content you want to translate. You can search and sort translatable documents (pages and components).

![Translation dialog showing locale selection on the left and content selection on the right](/_fern-img/bfeeed37a3cfa63d2592c2fb29ee9744b1626c572a117fff4dc3163d58789f52.webp)

> **Info**
>
> Existing translations for the selected content will be overwritten. Items not selected are left unchanged.

Click **Continue** when you're ready.

#### Review and confirm

A confirmation screen summarizes the number of locales being translated and shows the AI translation instructions that will be applied. You can click **Edit** to update your instructions before proceeding.

![Confirmation step showing a summary of the translation request and the AI translation instructions](/_fern-img/f9f01ad0f9bb145312a3da142f7879e1071273600e59ce956d78499a63bd0804.webp)

Click **Translate site** to start the job.

## View translation history

The **History** tab in the translation dialog shows all past and in-progress translation jobs. Each job is listed with a timestamp. Jobs currently running show a **Translating** indicator.

![History tab showing translation jobs with timestamps, statuses, and a Retry failed translations option](/_fern-img/d209b23c98b7f383cab15deebafc9085ca639f3d59b6cb66df3a115062a7f47d.webp)

If a job completes with errors—for example, content the AI could not translate—a **Retry failed translations** button appears. Click it to re-run only the failed items.