> ## Documentation Index
> Fetch the complete documentation index at: https://docs.brandblox.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Write email copy with AI

> Draft your subject line, preview text and copy from a short brief, in your brand's Voice

# Write email copy with AI

Give AI a short brief and get a first draft of your subject line, preview text, copy and buttons, written in your brand's Voice. It uses your own AI provider and only runs when you ask.

## Before you start

* Open an email that has a brand, so AI can follow its Voice.
* Add the Blox you want filled. AI writes into existing text and buttons. It doesn't add Blox or languages.
* Connect OpenAI, Claude or OpenRouter. See [Connect an AI provider](https://docs.brandblox.app/integrations/how-to-connect-an-ai-provider.md). If you haven't yet, clicking **Write with AI** takes you to set one up.

## Write the whole email

1. In the toolbar, click **Write with AI** (the sparkles icon).
2. If you're asked to add an integration, add it, then click **Write with AI** again.
3. Choose an **AI integration**, then write a brief: your offer, audience and any tone notes.
4. Click **Generate** and review the suggested changes.
5. Click **Apply**. The copy goes into your main language (usually English). Other languages aren't changed, so you can [add translations](https://docs.brandblox.app/emails/how-to-add-a-language-to-an-email.md) when you're ready.

## Rewrite one piece of copy

1. In Design mode, select a **Text** or **Call-To-Action**.
2. In **Settings**, click **Write with AI** (the sparkles icon) next to the copy field.
3. Write a brief, click **Generate**, review the suggestion, then click **Apply**.

## Good to know

* Fields with personalisation tags, such as `{{…}}` or `{%…%}`, are skipped, so your tags stay intact.
* Links, image alt text and layout aren't changed.
* AI writes into your HTML version, not the AMP version.
* If your email already has other languages, review them after you apply.

## Related

* [Edit email copy in Content mode](https://docs.brandblox.app/emails/how-to-edit-email-copy-in-content-mode.md)
* [Write Content with AI](https://docs.brandblox.app/content/how-to-write-content-with-ai.md)
* [Connect an AI provider](https://docs.brandblox.app/integrations/how-to-connect-an-ai-provider.md)
* [Add a language to an email](https://docs.brandblox.app/emails/how-to-add-a-language-to-an-email.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.