---
title: Email Content Translation agent
slug: agent-platform/docs/email-content-translation-agent
docTags: 
createdAt: 2026-08-12T15:37:08.000Z
---

**Email Content Translation** is an Optimizely Agent Platform agent that translates a full email in Optimizely Campaign into a target language. The translation covers the body, subject line, preview text, and image alt-text. The agent displays the original and translation side-by-side in a canvas.

- **Challenge** – Manually translating email content while keeping accuracy, cultural relevance, and brand voice across languages is slow and error-prone.
- **Agent outcome** – The agent retrieves the full email and translates the body, subject, preview, and alt-text. It then shows the original and translation side-by-side.
- **Value** – Faster, consistent email translation that preserves accuracy, cultural relevance, and brand voice.

## Required Optimizely products

Optimizely Campaign

## Install agent

:::hint{type="info"}
**Note**

**Mark Administrators**, **Agent Builders**, and users with the **Add, edit, and install specialized agents** attribute for a custom role can add agents to their organization's Optimizely Agent Platform instance. See [Add users and set permissions.](../../get-started/get-started-with-optimizely-opal-for-administrators.mdx)
:::

Install the agent from the **Directory**.

1. Go to **Directory > Agents**.
2. (Optional) Begin entering *Email Content Translation* or use the drop-down list filters to narrow the list.
3. Click **Install** on **Email Content Translation** to add it to your Agent Platform instance.

   ![Click Email Content Translation ](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/l7zXY8y6hxBRZm3KZhowv-20260720-145030.png)

:::hint{type="info"}
**Note**

If **Install** is disabled, ensure you have the [Required Optimizely products](docId\:IF7rqFosZvzPd1p5-7_DS) connected to your Agent Platform instance.
:::

## Use the agent

In [Mark chat](docId\:dtNBEttEGVvkhNkwNypLM), enter *@email\_content\_translation* and optionally provide the following details:

- (Optional) `target_language` – The target language for the translation, for example *French*, *German*, or *es-ES*.
- (Optional) `campaignName` – Name of the Smart Campaign to translate.
- (Optional) `campaignId` – ID of the Smart Campaign to translate.
- (Optional) `mailingId` – ID of the mailing within the campaign.
- (Optional) `transactionalMailId` – ID of the transactional mail.
- (Optional) `transactionalmessageId` – ID of the child message within the transactional mail.
- (Optional) `website_url` – URL of the online version of the email.

:::hint{type="info"}
**Note**

Provide a target language. Identify the email in one of three ways: a Smart Campaign (`campaignName` or `campaignId`, plus `mailingId`), a transactional mail (`transactionalMailId` and `transactionalmessageId`), or a `website_url`.
:::

The agent displays the original and translated content side-by-side in a [canvas](docId:1_VDSKJ_RG0FEQe0MCTv1). The canvas contains a two-column table with the original email in one column and the translation in the other. Click **Copy** on any line to copy that text, or **Copy all** to copy the full translation.

To use the Email Content Translation agent in a [workflow agent](docId:2HD0fUsIsfdek516VtN9l), drag and drop it into your workflow. See [Create a workflow agent](docId\:KWaI2TBwD38sN7p74exoy).

## Details

These are the default details of the **Email Content Translation** agent. After you [install the agent in your Agent Platform instance](docId\:IF7rqFosZvzPd1p5-7_DS), customize these details for your organization's needs. See [Manage agents](docId\:SSeNiblVMXwVvDR_lhtvI) for instructions.

### Input variables

The **Email Content Translation** agent takes the following input:

- (Optional) `campaignId`
- (Optional) `campaignName`
- (Optional) `mailingId`
- (Optional) `target_language`
- (Optional) `transactionalMailId`
- (Optional) `transactionalmessageId`
- (Optional) `website_url`

### Tools

The **Email Content Translation** agent uses the following tools internally to process your request:

- `browse_web`
- `browse_web_html`
- `campaign_get_smart_campaign`
- `campaign_get_smart_campaign_message_content`
- `campaign_get_smart_campaign_list`
- `campaign_get_smart_campaign_messages`
- `campaign_get_transactional_mail_message_content`
- `campaign_get_transactional_mail_messages`
- `campaign_get_transactional_mail`
- `campaign_get_transactional_mail_list`
- `create_canvas`

### Additional details

The agent uses the following default configuration:

- **Inference level** – Balanced. Provides reliable answers with additional reasoning.
- **Files** – `agentstyling_20260429.html`. Canvas styling template.
- **Output** – Text.

:::hint{type="info"}
**Note**

If you use Opti ID, administrators can turn off generative AI in the Opti ID Admin Center. See [Turn generative AI off across Optimizely applications](docId\:X5U0kKD2azV5cIdNqwGNj).
:::