How to Embed a Widget on Mailchimp
Mailchimp's page builder includes a Code content block that lets you add custom HTML to landing pages and websites. This guide covers how to embed an Embeddy widget on Mailchimp pages using the Code block. Note that email campaigns do not support iframes — this guide applies to Mailchimp landing pages and websites only.
Mailchimp emails do NOT support iframes
Email clients strip iframes and most JavaScript. You cannot embed an Embeddy widget in a Mailchimp email campaign. This guide is for Mailchimp landing pages and Mailchimp websites only. For emails, include a link to the page where the widget is hosted.
1. Prerequisites
- •An active Embeddy account with at least one published widget.
- •A Mailchimp account (Free, Essentials, Standard, or Premium plan). Landing pages are available on all plans; websites require the Standard plan or above.
- •Your Embeddy iframe embed code — copy it from your widget's Embed tab in the dashboard.
- •An existing Mailchimp landing page or website page to embed the widget on.
Your Embeddy iframe code:
<iframe src="https://embeddy.ai/webhost/WIDGET_ID?widget_props_id=PROPS_ID" width="100%" height="500" frameborder="0"> </iframe>
2. Method 1 — Code Content Block (Recommended)
The Code content block is Mailchimp's tool for adding custom HTML to landing pages. It accepts raw HTML including iframes and script tags.
Use this method to embed your Embeddy widget on a Mailchimp landing page. The Code block gives you full control over the HTML rendered on the page.
- 1
Open your landing page in the Mailchimp builder
In Mailchimp, go to Campaigns > Landing Pages (or Website). Find the page you want to edit and click Edit to open the page builder.
- 2
Add a Code content block
In the builder, click Add Content Block (the + icon) in the section where you want the widget. From the block list, select Code. A new code block will be added to the page.
- 3
Open the code editor
Click the Code block on the page. The code editor panel will open on the right side, showing an HTML editing area.
- 4
Paste your Embeddy iframe code
Clear any placeholder HTML and paste your Embeddy embed code:
<iframe src="https://embeddy.ai/webhost/WIDGET_ID?widget_props_id=PROPS_ID" width="100%" height="500" frameborder="0"> </iframe>
- 5
Save and close the editor
Click Save & Close (or click outside the code editor) to apply the code. The block may show a preview of the widget or a placeholder — this varies by browser.
- 6
Publish the page
Click Publish in the top-right corner. Visit the live page URL to confirm the widget renders correctly.
Tip: The Code content block may not render a live preview of the iframe in the editor. This is normal. Always check the published page to verify the widget displays correctly.
3. Method 2 — Mailchimp Website Builder
If you are using Mailchimp's Website Builder (available on Standard and Premium plans), the process is similar. The website builder also supports Code content blocks.
When to use this method: You have a Mailchimp website (not just a landing page) and want to add an Embeddy widget to one of your website pages.
- 1
Open your website in the Mailchimp builder
In Mailchimp, go to Website and click Edit Site to open the website builder.
- 2
Navigate to the page you want to edit
Select the page from the page list in the left panel.
- 3
Add a Code block
Click the + icon in a section to add a new block. Select Code from the block options.
- 4
Paste the iframe code and publish
Click the Code block, paste your Embeddy iframe code in the editor, click Save, then Publish your website.
4. Important: Email Limitations
Iframes are NOT supported in Mailchimp email campaigns
Email clients (Gmail, Outlook, Apple Mail, Yahoo Mail, etc.) strip iframes and JavaScript from email HTML for security reasons. This is an email client limitation, not a Mailchimp limitation.
What to do instead:
- •Embed the widget on a Mailchimp landing page (Method 1 above).
- •In your email campaign, include a button or link pointing to the landing page where the widget is embedded.
- •Use a screenshot or preview image of the widget in the email as a visual CTA, linking to the live page.
5. Troubleshooting
Widget does not appear on the published page
Ensure you clicked Publish after saving. Also verify you used the Code content block, not a regular text block. Text blocks may strip HTML tags.
Code block shows blank area in the builder
Mailchimp's builder may not render iframe content in the editor preview. This is expected. Check the published page URL to verify the widget renders.
Widget is cut off or has incorrect dimensions
Adjust the width and height attributes in your iframe code. Mailchimp pages have a fixed content width — use width="100%" to fill the available space.
Cannot find the Code content block
The Code block is available in Mailchimp's landing page and website builders. If you do not see it, ensure you are editing a landing page or website (not an email campaign). In the email builder, the Code block has different capabilities and does not support iframes.
Widget does not display on mobile
Mailchimp landing pages are responsive by default. Ensure your iframe uses width="100%" to adapt to mobile screen widths. The height remains fixed, so choose a value that works on both desktop and mobile.
6. FAQ
Can I embed a widget in a Mailchimp email?
No. Email clients do not support iframes or JavaScript. Embed the widget on a Mailchimp landing page and link to it from your email campaign instead.
Is the Code content block available on the free Mailchimp plan?
Mailchimp landing pages (and their Code blocks) are available on all plans including the free tier. The Website builder requires a Standard or Premium plan.
Does the widget affect my Mailchimp landing page performance?
Iframes load asynchronously and do not block the main page rendering. Embeddy widgets are optimized for fast loading, so the impact on page performance is minimal.
Can I add multiple Code blocks to the same page?
Yes. You can add multiple Code content blocks to a Mailchimp landing page or website page. Each block can contain a different Embeddy widget.
Do I need a developer to embed the widget on Mailchimp?
No. The Code content block is a standard drag-and-drop element in Mailchimp's page builder. Just paste the iframe code — no programming required.
Ready to embed on Mailchimp?
Create your widget in Embeddy's no-code builder and add a Code content block to your Mailchimp landing page in minutes.
Start for Free