Free tools Windows power users keep installed
One-click scans. No signup required.
iTechGuides is reader-supported. When you buy through links on our site, we may earn an affiliate commission. As an Amazon Associate I earn from qualifying purchases. Learn more
Antihost offers managed WordPress hosting with free migration, one-click staging and a 14-day free trial.
The right way to connect Mailchimp to WordPress depends on your site type and what you need to synchronize. On WordPress.com, use the Mailchimp block after connecting the site. On self-hosted WordPress.org, the official Mailchimp List Subscribe Form plugin is the simplest full-featured option; an embedded form or popup code is better when you only need a signup form. WooCommerce stores should use Mailchimp for WooCommerce to synchronize customers and orders. A custom Marketing API integration is appropriate when these standard methods cannot support your workflow.
This guide explains each route, the exact setup sequence, what data is transferred, how to test it, and how to fix the most common connection failures.
Choose the connection method before you install anything
WordPress is not one hosting product. WordPress.com has plan-level restrictions and a managed editor, while a self-hosted WordPress.org installation lets you install plugins and paste code wherever your theme permits. WooCommerce adds a separate requirement: customer and order data must be synchronized, not just an email address from a newsletter form.
| Method | Best for | Data scope | Control | Maintenance |
|---|---|---|---|---|
| WordPress.com Mailchimp block | Sites using the WordPress.com editor | Signup submissions | Block settings and text fields | Managed by WordPress.com and Mailchimp |
| Mailchimp List Subscribe Form plugin | Self-hosted WordPress.org sites wanting a reusable form | Signup submissions, merge fields, and groups exposed by the form | Block, widget, and shortcode placement | Plugin updates and OAuth connection |
| Embedded signup form | A single form in a page, post, or HTML-capable widget | Signup submissions | Editable generated markup and styling | You maintain the pasted markup |
| Popup form | Visitors who should see an overlay signup prompt | Signup submissions | Popup design and display code | Connected-site automation or manual script |
| Mailchimp for WooCommerce | Stores that need customer and order synchronization | WooCommerce customers, orders, and related ecommerce data | Audience mapping and integration settings | Plugin version and synchronization monitoring |
| Marketing API integration | Custom forms, CRM imports, webhooks, or special synchronization logic | Whatever your integration is programmed to send and receive | Highest | Developer-owned code, credentials, and error handling |
Do not install several methods for the same form unless you deliberately need separate audiences or workflows. Multiple scripts or plugins can create duplicate forms, duplicate contacts, or conflicting field mappings.
#1 Best Overall
Prepare Mailchimp and WordPress
Decide which audience receives the data
Every form or integration must target a specific Mailchimp audience. Select that audience before configuring the WordPress side, then confirm its required fields, merge tags, groups, and tags. A form that points to the wrong audience can appear to work while sending subscribers to a list your team does not monitor.
List the fields you actually need
Email-only collection is the least complicated. If you need first name, company, interests, or other values, enable the corresponding audience fields and expose them in the block, plugin, or embedded form. Keep required fields to a minimum: every required field adds friction and creates another way for a submission to fail.
The Tool Desk
Outbyte Driver Updater FREEScan for outdated or missing drivers - takes under a minuteDriver Scan →Outbyte PC Repair FREERepair Windows errors before they cause bigger problemsFix Now →Plan a controlled test
Use an address you control rather than a real customer address. After submission, inspect the contact in Mailchimp and verify its subscription status, audience, tags or groups, and field values. This confirms the complete path instead of merely proving that a button can be clicked.
Connect Mailchimp on WordPress.com
WordPress.com provides a Mailchimp block for the block editor. Mailchimp states that signup forms can be added directly only on paid Business or eCommerce WordPress.com plans; sites on other plans can use a Mailchimp block. Plan rules can change, so check the current requirements shown in your account before choosing a method.
- Connect the WordPress.com site to your Mailchimp account using the connection option presented by the Mailchimp or WordPress.com integration.
- Open the WordPress Editor for the page or post where the form should appear.
- Insert the Mailchimp block from the block inserter.
- Choose the Mailchimp audience that should receive new subscribers.
- Configure the placeholder text, submit button text, success message, error message, and terms text. Match the wording to the fields you enabled in the audience.
- Publish or update the page, then submit your controlled test address.
- In Mailchimp, check that the contact reached the intended audience with the expected status and field values.
If the block is available but direct signup-form functionality is restricted on your plan, keep the block-based route or move the form to a supported plan. Do not assume that a missing control is a WordPress editor bug.
Use the official plugin on self-hosted WordPress.org
The official Mailchimp List Subscribe Form plugin is designed for self-hosted WordPress installations. Its repository says a typical installation and setup takes about 5–10 minutes; that is the project’s estimate, not an independently measured time.
Install and authorize the plugin
- In the WordPress administrator, go to Plugins → Add New.
- Search for Mailchimp List Subscribe Form, install the official plugin, and activate it.
- Open the plugin’s Mailchimp settings and start the OAuth login flow.
- Sign in to Mailchimp and approve the connection. OAuth avoids pasting a permanent API key into a WordPress form.
- Return to WordPress and select the audience that should receive submissions.
The plugin encrypts the OAuth access token in the WordPress database. If relevant WordPress security constants are rotated, the connection may need to be authorized again.
Map fields and groups
- Enable the audience merge fields that the form should collect.
- Select any groups or interest options that subscribers should be able to choose.
- Save the settings and check that required Mailchimp fields are represented in the form configuration.
A required audience field that is not exposed by the form is a common reason for a submission to fail or for a contact to be created without the value you expected.
Place the form
The plugin can expose a block, a widget, and a shortcode. Use the block when working in the block editor, a widget when the theme provides a suitable widget area, or the shortcode when you need placement inside classic content or a template that accepts shortcodes.
[mailchimpsf_form]- Insert the Mailchimp block, add the plugin widget, or paste the shortcode into the target page, post, or widget area.
- Preview the page on desktop and mobile.
- Submit the controlled test address.
- Verify the contact, status, groups, tags, and field values in Mailchimp.
Add a Mailchimp embedded signup form
An embedded form is useful when you do not need a site-wide plugin workflow. In Mailchimp, create an embedded signup form for the intended audience and copy the generated markup. Paste it into an HTML-ready WordPress location, such as a Custom HTML block, an HTML-capable widget, or a page area that accepts the generated code.
Recommended Free Tools
- Open the audience’s signup-form tools in Mailchimp and choose the embedded form option.
- Choose the fields and presentation options, then generate the form markup.
- Copy the markup without changing the form action or field names.
- In WordPress, edit the destination page and insert a Custom HTML block, or use an equivalent HTML-capable area supplied by your theme.
- Paste the markup, save, and inspect the rendered form.
- Submit a test address and confirm the result in the selected Mailchimp audience.
Mailchimp says many sites work best with JavaScript disabled or with its unstyled embedded form. If the styled version does not render correctly, try the unstyled form rather than repeatedly changing theme CSS. Your theme, caching layer, or security plugin may also alter scripts or markup after you save the page.
Add a Mailchimp popup to WordPress
Popup forms use code that must be rendered on the pages where the popup should appear. They are separate from an inline form, so publishing an embedded form does not automatically create a popup.
Automatic connection
- Design and publish the subscriber popup in Mailchimp.
- If the WordPress site is connected through Mailchimp’s integrations, allow Mailchimp to push the popup code automatically.
- Visit the public site in a private browser window and wait for the popup’s configured trigger.
- Submit a controlled test address and inspect the contact in Mailchimp.
Manual connection
- In Mailchimp, open Connected sites and choose the manual connection option when the site is not connected through an integration.
- Copy the generated popup code.
- Paste it into a location that WordPress actually renders, such as a theme-supported header, footer, sidebar, navigation area, or an HTML-capable page or post.
- If your theme does not support code in its header, footer, sidebar, or navigation areas, Mailchimp recommends using a post or page instead.
- Clear any page cache and test the popup on the public URL.
A popup can be correctly configured in Mailchimp and still remain invisible if its script was pasted into an editor field that strips scripts or into a template part the theme does not display.
Connect Mailchimp to WooCommerce
Use the official Mailchimp for WooCommerce integration when the objective includes customer and order synchronization. This is broader than a newsletter form: the integration adds WooCommerce customers and order information to a Mailchimp audience.
- Install and activate Mailchimp for WooCommerce from the WordPress administrator.
- Open the integration settings and authorize the Mailchimp account.
- Select the audience that should receive WooCommerce customer data.
- Review the audience mapping before enabling synchronization. Confirm which customer attributes, order details, and consent-related choices are being transferred.
- Save the connection and monitor its initial synchronization.
- Place or use a controlled test order, then verify the customer and order record in Mailchimp.
The integration uses Marketing API v3.0. Mailchimp documents support for popup forms and product-retargeting email features in specified plugin versions, so check the current plugin-version requirements before relying on either feature. If records are incomplete or a mapping changed, the integration provides an audience resynchronization option. Review the mapping first and resynchronize only after you understand what will be sent; Mailchimp says resynchronization can occur without losing ecommerce data.
Build a custom Marketing API integration
Choose custom code only when a block, plugin, embedded form, popup, or WooCommerce integration cannot represent the required workflow. Typical reasons include a custom registration form, importing records from a CRM, connected-site verification, webhooks, or synchronization rules that need application-specific logic.
Design the data flow
- Define the source of truth for each field and which Mailchimp audience receives it.
- Map local fields to Mailchimp merge fields, tags, or groups.
- Decide how updates, unsubscribes, deletions, retries, and duplicate addresses are handled.
- Specify which events require a webhook and how your application records failures.
Implement and secure it
- Use Mailchimp’s current Marketing API documentation rather than an obsolete endpoint or library.
- Keep credentials on the server and out of page source, theme files visible to editors, and client-side JavaScript.
- Validate and normalize submitted data before sending it.
- Implement timeouts, retry limits, logging that excludes secrets, and a way to reprocess failed events.
- Test new contacts, updates, duplicate submissions, invalid fields, and API failures in a non-production workflow where possible.
Mailchimp identifies connected sites, embedded signup forms, and audience synchronization as supported building blocks for integrations. A custom integration gives you control, but it also makes your team responsible for API changes, webhook delivery, credential rotation, and synchronization errors.
Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.Verify the connection end to end
Do not treat a visible form as proof that the integration works. Use this sequence after the initial setup and after significant plugin, theme, or audience changes.
Do these 3 things before closing this tab:
1Clear out junk files and repair common Windows errors2Fix the driver behind crashes, sound loss and screen glitches3Repair Windows errors before they cause bigger problems- Open the public page in a private browser window so an existing session or cached result does not hide a problem.
- Submit an address that you control, completing every required field and group choice.
- Record the exact time and address used for the test.
- In Mailchimp, open the intended audience and locate the contact.
- Check the contact’s subscription status, tags or groups, and every mapped field.
- For WooCommerce, confirm that the customer and the test order are associated with the expected ecommerce data.
- For a popup, repeat the test on a second page and on a mobile viewport to confirm that the script is loaded where intended.
Troubleshoot by symptom
The Mailchimp block or plugin is missing
- On WordPress.com, verify that your plan supports the form method you selected. Direct signup forms are limited to paid Business or eCommerce plans according to Mailchimp; other plans can use a Mailchimp block.
- On WordPress.org, confirm that the official plugin is activated and that your user account can manage plugins and widgets.
- Clear the editor, page, and server caches after activation.
The form appears, but submissions do not arrive
- Reopen the settings and confirm the selected audience.
- Check that required audience fields are enabled and exposed in the block, plugin, or embedded markup.
- Submit a new controlled test address and look for an error message rather than relying on the page’s visual confirmation.
- Inspect security, caching, or script-blocking plugins that could prevent the request from completing.
A contact arrives with missing or incorrect values
- Compare the form’s field names with the audience merge fields.
- Confirm that groups and tags are mapped to the intended options.
- For WooCommerce, review the integration’s audience mapping before running a resynchronization.
The popup never appears
- Confirm that the site is connected in Mailchimp or that the manual script is present.
- Check whether WordPress stripped the script from the editor area.
- Move the code to a rendered header, footer, sidebar, navigation area, or a post or page, as supported by the theme.
- Test without an ad blocker and clear page caches.
OAuth stopped working
The official plugin encrypts its OAuth token in the WordPress database. If relevant WordPress security constants were rotated, reconnect the plugin through its OAuth settings and repeat the end-to-end test.
WooCommerce data is incomplete
- Check the integration status and the plugin-version requirements for the feature you are using.
- Review audience mapping before resynchronizing.
- Run a controlled test order and verify both the customer and order records in Mailchimp.
Which Mailchimp WordPress option is best?
Use the smallest method that meets the data requirement. The official List Subscribe Form plugin is the practical default for a self-hosted site that needs reusable forms, merge fields, and multiple placement choices. An embedded form is more appropriate when one page needs a simple signup and you want to edit the generated HTML. A popup is the right choice for an overlay experience, provided your theme can render the script. WooCommerce requires the dedicated integration when customer and order records matter. WordPress.com users should start with the Mailchimp block and check their plan before attempting a different path. Choose the Marketing API only when standard components cannot express the required synchronization logic.
Quick Recap
Maintenance after launch
- Keep the WordPress plugin, WooCommerce integration, theme, and caching layer updated through your normal change process.
- Retest a form after changing audience fields, merge tags, groups, theme templates, security plugins, or consent wording.
- Review connected-site status and synchronization errors rather than assuming a previously successful connection remains healthy.
- Protect OAuth tokens and API credentials, and rotate them according to your organization’s security policy.
- Document the audience, fields, tags, groups, and WordPress locations used by each form so another administrator can troubleshoot it.
Final setup checklist
- The method matches your environment: WordPress.com, self-hosted WordPress.org, or WooCommerce.
- The intended Mailchimp audience is selected and its required fields are mapped.
- The form, popup, or synchronization code is placed where WordPress actually renders it.
- A controlled test confirms the contact’s audience, status, tags or groups, and field values.
- WooCommerce tests confirm both customer and order data when ecommerce synchronization is enabled.
- Custom integrations protect credentials and handle retries, webhooks, and synchronization failures.
Product prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on Amazon at the time of purchase will apply.
