How to Use the New Block-Based Email Editor (Alpha)

MailPoet includes a new email editor built on the WordPress block editor. This alpha version lets you design newsletters using the same block-based workflow you already know from creating WordPress posts and pages. Because the feature is still in alpha, it may change as development continues.

Note: This feature is currently in alpha. It is functional and available for testing, but you may encounter occasional issues. Emails created with the new block editor cannot be edited in the classic MailPoet editor, and vice versa.

Prerequisites

MailPoet plugin version 5.6.1 or later
WordPress 6.x or later

How to Create a Newsletter with the Block Editor

In your WordPress dashboard, go to MailPoet > Emails.
Click Add new email.
In the Newsletter section, click the small downward arrow next to the Create button.
Select Create using the new email editor (Alpha).

Choose a template to start with. The following pre-built templates are available:

Newsletters — a general-purpose email layout
Sales Announcements — promote sales, discounts, and special offers
Educational Campaign — share tips, tutorials, or educational content with subscribers
Events — announce upcoming events, webinars, or meetups
Welcome — greet new subscribers when they join your list
Post-Purchase — follow up with customers after they complete an order
Abandoned Cart — remind customers about items left in their cart

You can also start from a blank template.

Design your email using blocks. Click the + icon to open the block library and browse the available blocks in the left sidebar. See the Available Blocks section below for a full list.

7. When your design is ready, proceed to configure your sending options (subject line, recipients, and schedule) and send or schedule your email.

How to Use the Block Editor for Automation Emails

You can also use the new block editor to create and edit emails within MailPoet automations.

Go to MailPoet > Settings > Advanced.
Scroll down to Use block email editor for automation emails.
Select Yes and click Save settings.

Once enabled, any new automation emails you create will open in the block editor instead of the classic editor.

Important: Automation emails created with the block editor will not be visible or editable in the classic editor. If you switch this setting back to No, previously created block-based automation emails will still use the block editor when opened for editing.

Available Blocks

The block editor for emails supports a curated set of blocks that render reliably across email clients. Click the + icon in the editor to open the block inserter and browse the categories below.

Text

Paragraph — add and format text content such as body copy, introductions, or announcements.
Heading — add headings (H1 through H6) to structure your email and guide readers through sections.
List — add bulleted or numbered lists to organize information.
Table — insert a table to display data in rows and columns.
Quote — add a styled blockquote to highlight a testimonial, review, or notable excerpt.

Media

Image — insert, resize, and link images. You can upload from your Media Library or paste a URL.

Design

Spacer — add adjustable vertical space between blocks to control the layout.
Columns — create multi-column layouts (for example, two or three columns side by side).
Group — wrap multiple blocks together and apply shared background colors, padding, or borders.
Buttons — add one or more call-to-action buttons with customizable text, link, color, and style.

Widgets

Social Icons — add a row of social media icons linking to your profiles on platforms like Facebook, Instagram, X (formerly Twitter), and others.

Theme

Site Logo — display your site’s logo as set in WordPress > Appearance > Customize.
Site Title — display your site’s name as configured in WordPress > Settings > General.

WooCommerce

These blocks are available when WooCommerce is active on your site. They let you showcase products directly inside your emails.

Coupon Code — insert a WooCommerce coupon code that subscribers can use at checkout.
Product Collection — display a dynamic collection of products based on custom filters and sorting rules.
Featured Products — highlight one or more featured products with images, prices, and a link to the product page.
New Arrivals — showcase your most recently added products.
On Sale Products — display products that currently have an active sale price.
Best Sellers — show your top-selling products.
Top Rated Products — display the highest-rated products based on customer reviews.
Hand-Picked Products — manually select specific products to display in your email.
Products by Category — show products from one or more WooCommerce categories.
Products by Tag — show products that match specific WooCommerce tags.
Products by Brand — display products filtered by brand.
Related Products — show products related to a specific item.
Upsells — display upsell product suggestions.
Cross-Sells — display cross-sell product recommendations.

Note: Not all standard WordPress blocks are available in the email editor. Only blocks that render reliably across email clients are included. If you paste content from a WordPress post or page that contains unsupported blocks (such as Gallery, Media and Text, Cover, Video, Audio, or Embed), they may still render in the sent email, but they cannot be added directly from the block inserter.

Differences from the Classic Editor

Feature	Classic Editor	Block Editor (Alpha)
Editing approach	Drag and drop from sidebar	WordPress block inserter
Layout building	Pre-built column layouts	Columns block with flexible configuration
Text editing	Inline text editor	Full block editor with rich formatting
Template system	MailPoet-specific templates	Block-based email templates
WooCommerce products	Limited product widgets	Full suite of WooCommerce product blocks
Compatibility	Classic emails only	Block emails only

Known Limitations

Because this feature is in alpha, keep the following in mind:

No cross-editor compatibility. Emails created in the block editor cannot be opened or edited in the classic editor, and classic emails cannot be opened in the block editor.
Block support is limited. Not all WordPress blocks are available in the email editor. Only blocks that render reliably across email clients are enabled.
Rendering differences. Some email clients (particularly older versions of Outlook) may display certain block styles differently than what you see in the editor preview.
Feature parity. Some features available in the classic editor (such as the Automatic Latest Content widget or the Posts widget) may not yet be available in the block editor.

Tips

Preview your email before sending. Use the preview option to check how your email looks, especially if you are using images or multi-column layouts.
Test across email clients. Since email rendering varies by client, consider sending test emails and checking them in multiple email applications.
Start simple. If you are new to the block editor, begin with a pre-built template and modify it to suit your needs.
WooCommerce product blocks require WooCommerce to be installed and active. If you do not see the WooCommerce category in the block inserter, confirm that WooCommerce is enabled on your site.