---
title: "AI Chat"
description: "Topol's AI Chat integrates an intelligent, context-aware assistant directly into the email editor, powered by OpenAI."
url: https://docs.topol.io/email-editor/guide/chat-ai.html
---

# AI Chat

> **This feature is available with the Plugin Expansion plan and higher.**
>
> If you're on the Plugin for Startup plan, consider upgrading to access this feature. For more details, visit our [pricing page](https://topol.io/pricing) or contact support.

AI Chat integrates a conversational assistant directly into the email editor, powered by **OpenAI**. **The template is sent along as context**, so the assistant can answer questions about the email and suggest edits to it without anything being pasted into a separate tool.

> **AI Chat or AI Assistant?**
>
> AI Chat is conversational and works across the whole template. The [AI Assistant](./ai-assistant.html) rewrites one selected block at a time. The [comparison below](#choosing-between-the-two) covers when each one fits.

To connect it with ChatGPT, which is essential for its functionality, you must first configure it. Instructions are available in [this article.](https://support.topol.io/en/articles/8329381-enabling-ai-features-in-topol-plugin)

## How to Enable AI Chat

Add the following option to your `TOPOL_OPTIONS` configuration:

```ts
chatAI: true,
```

**A new AI Chat button then appears in the top bar of the editor.** Clicking it opens a sidebar for typing prompts and interacting with the assistant.

### Chat on a Single Section

`chatAIOnSegment` adds a second entry point: an AI Chat icon on individual sections, which scopes the conversation to that section instead of the whole template.

```ts
chatAI: true,
chatAIOnSegment: true,
```

This option **requires `chatAI` to be enabled as well**, since it extends the same feature rather than replacing it.

## What Users Can Do

The sidebar opens with a set of one-click actions, and free-form prompts work at any point:

| Action | What it does |
| --- | --- |
| **Improve text** | Suggests stronger wording across the template |
| **Proof-read** | Reviews the copy as a whole |
| **Check grammar** | Reports spelling and grammar problems |
| **Optimize text for conversion** | Rewrites copy with a stronger call to action |

**Answers that contain edits come back as per-block suggestions**, each showing the original text, the proposed replacement, and a short comment explaining the change. Suggestions are applied one at a time or all at once with **Apply all**.

Only **text and button blocks** can be modified this way. Images, dividers, and other block types are left untouched.

## Choosing Between the Two

Both features call OpenAI, and the practical difference is what each one sees and what it changes:

-   **AI Chat** receives the whole template as context and can return suggestions for several blocks at once. It also answers questions without changing anything, which the assistant cannot do.
-   **[AI Assistant](./ai-assistant.html)** sends the text of one block and returns replacement text for that block.

**Reviewing an entire email or asking a question about it is what AI Chat is for.** A quick rewrite of a single paragraph is faster through the assistant.

## Monitoring Usage

Total token consumption is available from the [AI Assistant Logs](./ai-assistant-logs.html), which covers both AI Chat and the AI Assistant.

For more comprehensive details about the AI Chat feature, visit [this article](https://support.topol.io/en/articles/10801914-ai-chat).