You can embed any sent MailPoet newsletter directly into a WordPress post or page. This is useful when you want to showcase a specific newsletter to your website visitors, such as a recent announcement or a campaign highlight. The embedded newsletter appears inside the page as an interactive preview that visitors can scroll through.
There are two ways to embed a newsletter: using the MailPoet Newsletter block in the WordPress block editor or using the [mailpoet_newsletter] shortcode.
Which Newsletters Can Be Embedded
Only the following types of newsletters are eligible for embedding:
- Sent standard newsletters — regular email campaigns that have been sent.
- Sent post notification emails — individual notification emails that have already been delivered.
The following are not eligible:
- Draft or scheduled newsletters
- Welcome emails
- Automation emails
- Deleted newsletters
If a newsletter is not eligible, the embed will not display anything on the page.
Method 1: Using the MailPoet Newsletter Block
The MailPoet Newsletter block is the easiest way to embed a newsletter if you use the WordPress block editor (Gutenberg).
- Go to Posts or Pages in your WordPress dashboard and open the post or page where you want to embed a newsletter.
- Click the + block inserter icon and search for MailPoet Newsletter.
- Click the block to add it. You will see a placeholder prompting you to select a newsletter.
- Use the dropdown to search for a newsletter by subject line. The list shows your sent newsletters sorted by send date, with the most recent first.
- Select the newsletter you want to embed. A preview will appear in the editor.
Block Settings
After selecting a newsletter, you can customize how it appears using the block sidebar settings. Click the block, then open the settings sidebar on the right.
Size and Layout
- Height — Adjust the height of the embedded newsletter (between 200 and 3,000 pixels). The default is 800 pixels.
- Width — Adjust the maximum width (between 320 and 1,200 pixels). The default is 640 pixels.
- Newsletter alignment — Choose whether the newsletter is aligned to the left, center, or right within the content area. The default is center.
- Show email background — Toggle whether the original email background color is visible. When turned off, the background becomes transparent.
Fallback Link
- Show fallback link — Toggle the “View full newsletter” link that appears below the embedded newsletter. This link is helpful for visitors who may have trouble viewing the embedded version. It is enabled by default.
- Fallback link alignment — Choose left, center, or right alignment for the fallback link.
The block also supports wide and full alignment using the standard WordPress alignment toolbar controls.
Method 2: Using the Shortcode
If you prefer to use shortcodes or work with the classic editor, you can embed a newsletter using the [mailpoet_newsletter] shortcode.
Basic Usage
[mailpoet_newsletter id="123"]Replace 123 with the ID of the newsletter you want to embed.
Finding the Newsletter ID
- Go to MailPoet > Emails in your WordPress dashboard.
- Find the sent newsletter you want to embed.
- Click on the newsletter to edit it. The newsletter ID is the number shown in the browser’s address bar (for example,
admin.php?page=mailpoet-newsletter-editor&id=123).
Optional Attributes
You can customize the embed appearance by adding optional attributes to the shortcode:
| Attribute | Description | Default |
|---|---|---|
id | (Required) The newsletter ID. | — |
height | Height of the embed in pixels (200–3,000). | 800 |
width | Maximum width in pixels (320–1,200). | 640 |
iframe_alignment | Alignment of the newsletter: left, center, or right. | center |
show_email_background | Show the email’s original background color: 1 (yes) or 0 (no). | 1 |
show_fallback_link | Show a “View full newsletter” link below the embed: 1 (yes) or 0 (no). | 1 |
fallback_link_alignment | Alignment of the fallback link: left, center, or right. | center |
Example with Custom Settings
[mailpoet_newsletter id="123" height="600" width="720" iframe_alignment="left" show_email_background="0" show_fallback_link="1" fallback_link_alignment="right"]This embeds newsletter 123 at 600 pixels tall and 720 pixels wide, aligned to the left, with a transparent background and a right-aligned fallback link.
How the Embed Works
The embedded newsletter is displayed inside an iframe. This ensures that the newsletter’s email styling does not interfere with your website’s design, and vice versa. The iframe loads the same “view in browser” version of the newsletter that subscribers see when they click a view-in-browser link in their email.
Tip: If the newsletter content is longer than the embed height, visitors can scroll within the embedded area to read the full newsletter. Consider increasing the height or enabling the fallback link so visitors can open the full newsletter in a new tab.
You must be logged in to post a comment.