Changelog - March, 2026

New Features

Email AI UI/UX Config

Template Translation

AI now translates email templates inside the editor, either the whole template at once or individual blocks through the AI context menu.

Localizing a template previously meant exporting the content, translating it in an external tool, and pasting it back, which often broke formatting or corrupted Merge Tags. Template Translation runs in place and preserves structure, styles, and Merge Tags throughout.

It uses the same OpenAI integration as the AI Assistant, so no extra AI setup is needed if the AI Assistant is already configured. With Multilingual Templates enabled, translations save into the correct language mutation automatically.

Configure a valid OpenAI API token in the Plugin API token settings. A Translate button then appears in the Top Bar. With Multilingual Templates enabled, the translate action also sits next to each language mutation in the language settings dropdown.

For full details, see the documentation.

Improvements

Email Config UI/UX

Limit the Number of Files Uploaded at Once

The new maxUploadingFiles option caps how many files upload at once in the File Manager. Files over the limit are skipped with a notification. Setting the value to 1, for example, switches the browser file picker to single-file mode.

Integrations that proxy uploads to rate-limited services or run per-file server-side validation can be overwhelmed by large batch uploads. An upload limit prevents that without building a Custom File Manager.

Add maxUploadingFiles to the fileManagerPreferences object in TOPOL_OPTIONS:

fileManagerPreferences: {
  maxUploadingFiles: 5,
},

For full details, see the documentation.

Email Events API

Better Error Details in onError

The onError callback now takes an optional third parameter, responseBody, holding the parsed response body from your server. It previously provided only a generic message such as "Request failed with status code 422" with no access to the server response.

When the backend returns a descriptive message (for example "File exceeds 10 MB limit"), reading it from responseBody and showing it through TopolPlugin.createNotification() replaces the generic status code with actionable feedback.

No configuration is needed. Add the third parameter to the existing onError callback:

callbacks: {
  onError(error, statusCode, responseBody) {
    console.log(responseBody); // parsed server response
  },
},

For full details, see the documentation.

Email UI/UX

Merge Tag Search in TipTap Toolbar Shows Full Paths

Merge Tag search in the TipTap toolbar dropdown now shows the full breadcrumb path (for example "Contact > Personal > First Name") instead of only the tag name. The tree view still shows short names when browsing.

With deeply nested merge tag structures, searching a common term like "Name" previously returned a flat list with no indication of each tag's group. The breadcrumb path adds that context, making the right tag easier to identify.

Bugfixes

• Email Fixed an issue where the "Image size options" dropdown label and its values ("cover", "auto", "contain") were not recognized by textOverride.
• Email Fixed an issue where switching language mutations in preview mode did not reset the Dark mode toggle.