Topol Plugin Guide

Appearance

Changelog - June, 2025 ​

New Features ​

Custom Cloudflare R2 Storage ​

Until now, Topol Plugin allowed you to connect to Amazon S3, Google Cloud Storage, or set up your own self-hosted storage. Now, we are introducing a new option in our custom storage lineup: connect your Topol Email Editor to Cloudflare R2 buckets and keep every image, file, and template close to your existing Cloudflare Workers or Pages project.

Why It Matters ​

Cloudflare R2 exposes an S3‑compatible REST API—zero‑egress fees, globally distributed edge cache, and no vendor lock‑in. If your build pipeline already targets Workers, Pages, or uses Cloudflare KV, adding R2 keeps assets and templates in the same control plane.

How To Enable ​

For step‑by‑step walkthrough (with screenshots), see our documentation.

File Manager Preferences ​

Our built-in File Manager now comes with a dedicated fileManagerPreferences object, letting you fine-tune how files are displayed the moment the manager opens - no more manual toggling every time.

Why It Matters ​

The File Manager has always provided sensible defaults, allowing teams to drag-and-drop images effortlessly. However, workflows vary: some users organize assets visually, while others prefer a compact list. File Manager Preferences offer a single location to set the defaults, ensuring the Email Editor feels “right” for everyone the first time it loads.

How To Enable ​

Add the new fileManagerPreferences object within the TOPOL_OPTIONS configuration object. By default, files appear in List view. To start in Tiles view instead, set defaultTilesView inside this object to true:

ts
  fileManagerPreferences: {
    defaultTilesView: true, // true  = Tiles first
                            // false = List first (default)
  }

For additional information about this feature, see our documentation.

What’s Next ​

fileManagerPreferences ships with the first defaultTilesView switch, and we’ll expand it based on your feedback. Therefore, feel free to reach out to support if you’d like to add additional flags.

Improvements ​

Plugin Documentation Overhaul ​

This Topol Plugin documentation has been completely overhauled so that every page is clearer, better structured, and more user-friendly.

Improvement of Merge Tags Autosuggestion ​

Dropdown with Merge Tags autosuggestions now only appear when your input matches a defined merge tag and disappear as soon as it doesn’t. For example of this feature, see our documentation.

Swedish Translation Update ​

With the kind help of one of our Swedish customers, we’ve corrected and refined every string in the Svenska interface. If you ever spot a typo or an off-sounding translation in any language, just let us know and we’ll make it right in the next update. Tack!

Bugfixes ​

  • We fixed a bug that caused the TinyMCE text editor to unintentionally switch to a dark theme when using the Comments feature, making the text unreadable.
  • You can no longer leave a button completely empty, as this made it invisible and created potential for misuse.
  • We resolved an issue that caused structure control elements to disappear after the last block was removed.
  • We fixed an issue that prevented certain premade templates from loading into the Email Editor. To resolve this, add an Authorization Header to your Options configuration object. For more information, see our documentation.