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

MailPoet includes a new email editor built on the WordPress block editor. This beta 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 beta, it may change as development continues.

Note: This feature is currently in beta. 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.

Quick Links

Prerequisites

  • MailPoet plugin version 5.6.1 or later
  • WordPress 7.0 or later

How to Create a Newsletter with the Block Editor

  1. In your WordPress dashboard, go to MailPoet > Emails.
  2. Click Add new email.
  3. In the Newsletter section, click the Create button. The Choose an email editor dialog opens. If an arrow button appears next to Create, click the arrow instead. When the arrow is there, Create skips the dialog and opens the editor you chose last time.
  4. Select the “Block editor” option, and then click the Continue button. Select the “Remember my choice” checkbox to skip the dialog next time, or clear it to be asked every time.
  1. Choose an email pattern to start with. Patterns are pre-designed email layouts organized into categories. The following categories are available:
  • Newsletter — general-purpose email layouts
  • 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 (requires WooCommerce)
  • Abandoned Cart — remind customers about items left in their cart (requires WooCommerce)

You can also start from a blank template. For a detailed list of individual patterns and their requirements, see Email Patterns below.

  1. 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.
  1. When your design is ready, configure your sending options directly in the editor sidebar. See Sending Options below for details on setting the subject, recipients, schedule, and tracking.
  2. Click the Review and send button in the top-right corner to send your email immediately, or click Review and schedule if you have set a scheduled date. See Sending Options for more about the send button.

Sending Options

In the block email editor, you set the subject, recipients, schedule and tracking in the sidebar, without leaving the editor. To open them, click the Settings icon at the top right, then select the Email tab.

The Email tab shows the email’s name at the top, followed by the Settings, Inbox preview, Tracking and Template panels. A new email’s name follows its subject until you rename it.

Settings

The Settings panel holds everything you need before sending:

The Email tab in the MailPoet block email editor sidebar, showing the Settings panel with Subject, Preview text, Send, Recipients, the Show this newsletter in the archive toggle and Template, followed by the Inbox preview, Tracking and Template panels
  • Subject: the subject line subscribers see in their inbox. The counter recommends up to 60 characters. Personalize it with tags such as [site-title], [customer-firstname], [customer-lastname] and [customer-email].
  • Preview text: a short summary shown next to or below the subject line. The counter turns yellow past 80 characters and red past the 150-character maximum.
  • Send: when the email goes out. The default is Immediately. Click Immediately to pick a date and time, or click Now in the date picker to switch back.
  • Recipients: who gets the email. Click “Select recipients“, then choose “Send to all customers” (WooCommerce customers) or “Send to a segment” (one or more segments, with the total count shown).
  • Show this newsletter in the archive: lists the email on pages that use the MailPoet archive shortcode.
  • Template: the template the email uses.

Tip: If your site runs WordPress 7.0 or later with an AI provider configured, a Suggest with AI button with a sparkles icon will appear above the Subject and Preview text fields. Click it to generate up to four subject line and preview text pairs based on your email content, then click any suggestion to fill both fields at once. To set up an AI provider, go to Settings > Connectors in your WordPress dashboard. If no provider plugin is installed yet, you will see an Install button next to each available provider (Anthropic, Google, or OpenAI). Click Install to add the plugin automatically. Once installed, an API key field appears where you can enter your key from the provider’s website.

Inbox Preview

The Inbox preview panel shows how your email looks in a subscriber’s inbox: the sender name and address, the subject and the preview text. The sender details are the “From” name and address in the review panel (see Sender and Reply-to below). The preview updates as you type.

Tracking

The Tracking panel has one field, utm_campaign. Add a tracking code to use with Google Analytics. When a subscriber clicks a link in your email, this value is added to the link as the utm_campaign parameter, so you can follow the newsletter’s performance in your analytics reports. For more, see Track Newsletter Subscribers in Google Analytics.

The Inbox preview panel showing the sender name and address, subject and preview text, and the Tracking panel with the utm_campaign field

The Send Button

The send button in the top-right corner of the editor changes its label depending on your settings:

  • Review and send: appears when no schedule is set, so the email is sent immediately.
  • Review and schedule: appears when you set a date in the Send setting.
  • Save and continue: appears when you edit an automation email (see How to Use the Block Editor for Automation Emails).

The button opens the review panel, where you check the sender, schedule and recipients, and can send a test email before sending.

Sender and Reply-to

The Sender row in the review panel holds four fields: “From” name, “From” email address, “Reply-to” name and “Reply-to” email address. New emails use your default sender details, and you can change them for each email.

The review panel in the MailPoet block email editor with the Sender row expanded, showing the From name, From email address, Reply-to name and Reply-to email address fields, followed by the Send and Recipients rows

If the sender needs attention, the row shows Needs attention and a notice explains why:

  • “Not an authorized sender email address.”: with the MailPoet Sending Service, the “From” address must be authorized. Click “Authorize it now“. See How to Set Up MailPoet Sending Service.
  • “Will be sent as: …” or a domain warning: your sending domain isn’t authenticated, so MailPoet may send from a different address. See SPF, DKIM and DMARC.
  • “Subscribers may miss this email”: the “From” address is a free email address, such as Gmail. Click “Use recommended sender” to send from an address on your own domain and keep the free address as Reply-to, or click “Keep current sender“. See Your From Address Cannot Be Yahoo, Gmail or Outlook.

How to Use the Block Editor for Automation Emails

You can use the block editor for any email in a MailPoet automation. You choose the editor in the automation’s Send email step.

To create an automation email with the block editor, follow these steps:

  1. Open your automation and select the Send email step.
  2. Click the “Edit content” button. If an arrow button appears next to “Edit content“, click the arrow instead. When the arrow is there, “Edit content” skips the dialog and creates the email in the editor you chose last time, or the Classic editor if you haven’t chosen one.
  3. In the Choose an email editor dialog, select the “Block editor” option, and then click the Continue button.
  4. Design your email, and then click the “Save and continue” button to return to the automation.

Your Remember my choice setting applies to both newsletters and automations.

Automation templates and the block editor

Automation templates with starter content create their emails only when you set up each email. Open the template’s Send email step and click “Edit content“. MailPoet then creates the email in the editor you pick, using the template’s starter design:

  • Block editor opens the starter design in the block editor.
  • Classic editor opens a matching classic design directly, without the Templates page.

The starter design is used only for the first email in a step. If you delete that email, “Edit content” creates a blank email next time.

You can’t activate an automation until every Send email step has an email. Until then, MailPoet shows “Cannot activate the automation because an email has no content.”

An email that already exists stays in the editor it was made with. To move an automation email to the block editor, delete it from the Send email step. Then click “Edit content” and choose the block editor. The new email starts blank.

Email Patterns

Email patterns are pre-designed starting layouts you can choose when creating a new email. Each pattern includes placeholder content, images, and structure tailored to a specific use case. You can customize any pattern after selecting it.

The patterns available to you depend on whether WooCommerce is active on your site. Some patterns also require WooCommerce version 10.5.0 or later because they use the Coupon Code block.

General Patterns

These patterns are always available, regardless of whether WooCommerce is installed.

Pattern Description
Newsletter A general-purpose newsletter layout.
Product Restock Notification Notify subscribers when a product is back in stock.
Sale Announcement Promote a sale or discount offer.
New Products Announcement Showcase newly added products.
New Arrivals Announcement Highlight your latest arrivals with product imagery.
Educational Campaign Share tips, tutorials, or educational content.
Event Invitation Announce an upcoming event, webinar, or meetup.
Welcome Email Greet new subscribers when they join your list.

WooCommerce Patterns

These patterns appear only when WooCommerce is active on your site. They are designed for post-purchase follow-ups and cart recovery, and several include dynamic product blocks that automatically display relevant products in the sent email.

Pattern Description
First Purchase Thank You Thank a customer after their first order and suggest related products.
Post Purchase Thank You Thank a customer after any order and recommend additional items.
Product Purchase Follow-Up Follow up after a specific product purchase with tips or related products.
Abandoned Cart Remind customers about items left in their cart. Uses the Product Collection Cart Contents variant to automatically display each customer’s actual cart items.

WooCommerce Patterns with Coupon Code

These patterns include the Coupon Code block and require WooCommerce version 10.5.0 or later. If your WooCommerce version is older, these patterns will not appear in the pattern selector.

Pattern Description
Welcome with Discount Welcome new subscribers with a discount coupon to encourage their first purchase.
Win Back Customer Re-engage inactive customers with a discount offer and product suggestions.
Abandoned Cart with Discount Recover abandoned carts by offering a discount coupon. The pattern includes an auto-generated 10% discount coupon with a 1-day expiry and a “Finish checkout” call-to-action button. Uses the Product Collection Cart Contents variant to automatically display each customer’s actual cart items.

Tip: Patterns that include product blocks (such as the Post-Purchase and Abandoned Cart patterns) show placeholder images in the editor preview. When the email is sent, the placeholders are automatically replaced with real product data from your WooCommerce store.

Note: Abandoned cart patterns rely on WooCommerce cookie tracking to identify the products a customer left in their cart. Make sure cookie tracking is enabled in your MailPoet settings for these patterns to work correctly.

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.
  • Embed: add a video from YouTube, Vimeo, TikTok, Dailymotion, or VideoPress by pasting its link. Email clients can’t play video, so subscribers see the video’s thumbnail with a play button. Clicking the thumbnail opens the video on its site. If you paste a link from another site, the editor shows a warning and the email includes it as a plain link. For steps, see Embed a Video in a Newsletter.

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. Includes a Cart Contents variant that automatically shows the products a customer left in their cart, designed for use in abandoned cart emails.
  • 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.

MailPoet

  • Latest Posts: add your newest posts or pages, or posts you pick, to the email when it’s sent. See Show Your Latest Posts below.

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, or Audio), they may still render in the sent email, but they cannot be added directly from the block inserter.

Show Your Latest Posts

The Latest Posts block adds your newest posts or pages to an email. MailPoet picks the posts when the email is sent, so a scheduled email shows whatever is newest at that moment.

To add the block, follow these steps:

  1. Click the + block inserter and search for “Latest Posts”.
  2. Select the Latest Posts block.
  3. In the Settings sidebar, choose which posts to show.
  4. Change the post layout inside the block, if you want to.
The Latest Posts block in the email editor with its Posts and Layout settings in the sidebar

Choose which posts appear

The block’s settings control which posts appear and how many:

  • Selection: Latest posts picks your newest content automatically. Manual selection shows only the posts you pick in the “Choose posts” field, in the order you pick them.
  • Content type: Posts or Pages.
  • Number of posts and Order: how many to show (1 to 10) and whether the newest or oldest comes first. These only apply to Latest posts.
  • Categories & tags: show only posts in the categories and tags you pick. Turn on “Exclude selected categories & tags” to show every post except those. This only applies to Latest posts with Posts.
  • Password-protected posts: Show without content (the default) includes the title, featured image, and link, but not the content. Leave these posts out skips them. Treat like any other post includes them in full. Readers open your site and enter the password to read a protected post.
  • Columns: show posts in one or two columns.

Design the post layout

The block repeats one layout for every post. By default, each post shows its featured image, title, excerpt, and a “read more” link. Click inside the first post to add, remove, or reorder blocks, and the change applies to every post. Post blocks such as Post Title, Post Date, Post Author, Read More, and Post Content (the full post) only work inside this layout. Shortcodes in post content are removed from the sent email.

Editing the Header and Footer

The header and footer of a block-based email come from a separate template. They can be edited, but please note that any changes to the header or footer affect all emails, even existing templates.

If you wish to edit the Header or Footer, there are two ways to get to the template that controls this content.

Option A: Click in the Header block, and a pop-up will appear with an “Edit Template” link in it. Click the link to edit both Header and Footer blocks.

Option B: Double click in the footer area, and a pop-up will appear warning you that this is a template-based block, and asking you to continue. Click to Edit Template if you wish to continue.

Once you have opened the template editor for the Header and Footer, you can alter the text, fonts, colours, and insert new blocks such as the Social Media block.

Please do NOT edit or remove the Content Block, or the actual content of your Emails might not appear when sending.

Use the Save button to save the changes.

You will have to go back under MailPoet > Emails to find the email you were editing to resume working on that specific email.

Differences from the Classic Editor

FeatureClassic EditorBlock Editor
Editing approachDrag and drop from sidebarWordPress block inserter (“+” in upper left)
Layout buildingPre-built column layoutsColumns block with flexible configuration
Text editingInline text editorFull block editor with rich formatting
Template systemMailPoet-specific templatesBlock-based email patterns
WooCommerce productsLimited product widgetsFull suite of WooCommerce product blocks
Sending optionsConfigured on a separate page after the editorConfigured in sidebar panels within the editor
CompatibilityClassic emails onlyBlock emails only

Known Limitations

Because this feature is in beta, 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 classic editor widgets aren’t available in the block editor. For recent or hand-picked posts, use the Latest Posts block instead of the Automatic Latest Content or Posts widget.

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.