Changelog - May, 2026

New Features

Email Blocks Config API

Updated Product Block

The Product block now brings ecommerce products directly into the editor, in two modes:

• static mode, where users hand-pick specific products from a feed,
• dynamic mode, where the block connects to a Merge Tag and the ESP fills in real products at send time, looping over the array in the payload.

Ecommerce senders can build product-driven emails (featured collections, abandoned carts, "last viewed" rails, personalized recommendations) without leaving the editor or keeping a separate template per campaign. Static mode keeps hand-picked lineups self-contained; dynamic mode adapts a single template to each recipient at send time.

Static mode is the default. To make products available, expose the product feed endpoints described in the documentation.

For dynamic mode, set the following in TOPOL_OPTIONS:

emailServiceProvider: "sparkpost",
productMergetagTags: [
  { label: "Shopping cart", value: "MT_FOR_ARRAY" },
],
smartMergeTags: {
  enabled: true,
  syntax: {
    start: "{{",
    end: "}}",
  },
},

For full details, see the documentation.

Email Config UI/UX

Default Values in Editor

Default value support now spans the editor. The defaultTemplateSettings configuration presets how new templates and their blocks look from the first block, and each block's settings panel now resets individual properties back to their default at any time.

Defaults keep content visually consistent and aligned with a brand or design system from the first block. The per-setting reset turns those defaults into a safety net rather than a one-time starting point, so users can experiment and snap any value back to the agreed baseline.

Define the defaults under defaultTemplateSettings in TOPOL_OPTIONS:

defaultTemplateSettings: {
  emailWidth: 660,
  emailBackgroundColor: "#000000",
  hyperlinkColor: "#0066cc",
  text: {
    "font-family": "Helvetica, Arial, sans-serif",
    "font-size": 14,
    "line-height": 1.5,
  },
},

The per-setting reset controls need no configuration and appear automatically. For the full list of supported keys, see the documentation.

Email Blocks Config

Rating Block

The Rating Block collects feedback from recipients directly inside the email, available as a beta feature. Each segment is a clickable link, so a recipient's chosen score reaches your backend through the URL they open. It is configurable and fully translatable.

Rating inside the email, without a separate landing page, makes a response far more likely. As a dedicated block, a survey or CSAT prompt drops in by dragging, with no custom markup or Merge Tag setup.

Beta features are opt-in and disabled by default. Add the betaFeatures object to TOPOL_OPTIONS and set the flag:

betaFeatures: {
  rating: true,
},

For full details, see the documentation.

Improvements

Email UI/UX

Clipboard Image Support

Images now paste straight from the clipboard with Cmd/Ctrl + V, with no need to save the file and browse for it. There are two paste targets:

• The File Manager: pasting while it is open uploads the image into the current folder.
• The selected image block: pasting with an image block selected on the canvas replaces that block's image.

Pasting is the fastest path from having an image to placing it in a template, skipping the round-trip of saving a screenshot to disk and finding it in a file picker. That helps most with quick screenshots and copied product imagery.

Email Events Config

Programmatic Dark Mode Toggle

The new TopolPlugin.toggleDarkMode() method toggles the Dark Mode preview programmatically. The toggle previously lived only in the editor's preview toolbar; the same action is now available to the host page for a custom theming UI.

Call the method on the TopolPlugin instance. It only has a visible effect while the editor is in Preview mode:

window.TopolPlugin.toggleDarkMode();

For full details, see the documentation.

Email Events

onPreviewClose Callback

The new onPreviewClose callback fires when a user exits Preview mode and returns to the editor. There was previously only a signal on the way into preview (onPreview(html)); this closes that gap, so a host can hide a toolbar it showed during preview.

Add the handler to the callbacks object in TOPOL_OPTIONS:

callbacks: {
  onPreviewClose() {
    // The user has left Preview mode.
  },
},

This is purely additive. The existing onPreview(html) callback is unchanged.

Email UI/UX

Refreshed Image Editor Icons

The built-in image editor has a refreshed icon set. The updated icons are easier to recognize at a glance and bring the image editor visually in line with the rest of the Plugin.

Bugfixes

• Email Fixed a 403 Forbidden error that prevented saving cropped images for integrations using their own AWS S3 or Cloudflare R2 storage bucket.
• Email Fixed a "double snap" glitch in the drag-and-drop snapping behavior that could occur right after a block was deleted.