WP WooCommerce Mailchimp


WP WooCommerce Mailchimp provides simple and flexible Mailchimp integration for WooCommerce.

Automatically subscribe customers to a designated Mailchimp list and, optionally, Mailchimp interest groups and tags upon order creation or order completion.
This can be done quietly or based on the user’s consent with several opt-in settings that support international opt-in laws.

Upgrade to WP WooCommerce Mailchimp Pro for more advanced features including WooCommerce Subscriptions support and the ability to set product-specific lists, groups and tags.


WooCommerce Event Selection

  • Subscribe customers to Mailchimp after order creation
  • Subscribe customers to Mailchimp after order processing
  • Subscribe customers to Mailchimp after order completion

Works with Mailchimp Interest Groups and Tags

  • Set one or more interest groups to add users to based on the selected Mailchimp list.
  • Set one or more tags to add users to based on the selected Mailchimp list.

Opt-In Settings

  • MailChimp double opt-in support (control whether a double opt-in email is sent to the customer)
  • Optionally, display an opt-in checkbox on the checkout page (this is required in some countries)
  • Control the label displayed next to the opt-in checkbox
  • Control whether or not the opt-in checkbox is checked or unchecked by default
  • Control the placement of the opt-in checkbox on the checkout page

Translation Support

Would you like to help translate the plugin into more languages? Join our Translations Community at https://translate.wordpress.org/projects/wp-plugins/woocommerce-mailchimp.

WooCommerce Mailchimp translation is managed through WordPress language packs here: https://translate.wordpress.org. This allows WooCommerce Mailchimp to be translated into other languages. The preferred tool for translating plugins is called GlotPress. You can read about how GlotPress works in the WordPress Translator’s Handbook.

Thanks in advance for your help on any translation efforts!

We also support bundled translations via:

  • Included woocommerce-mailchimp.pot file
  • WPML support via wpml-config.xml

Included Translations:

  • English (US) (default)
  • French.

Custom Translations

If you don’t want to use WordPress language packs or bundled translations, you can use your own custom translations.

  • Place custom translations in /wp-content/languages/woocommerce-mailchimp/woocommerce-mailchimp_{lang}_{country}.mo. This ensures they won’t get overwritten by plugin updates.

Translation Loading

If no custom translations are present, languages will be loaded in the following order:

  • From WordPress language packs in: /wp-content/languages/plugins/woocommerce-mailchimp/woocommerce-mailchimp_{lang}_{country}.mo
  • From the plugin bundled in: /wp-content/plugins/woocommerce-mailchimp/languages/woocommerce-mailchimp_{lang}_{country}.mo


  • All features should work for each blog in multisite installations.


WP WooCommerce Mailchimp requires PHP 5.6+ (PHP 7.0+ recommended). You’ll also need to be running WordPress 4.7.0+ and have WooCommerce 3.5.0+.

Documentation & Support

Online documentation and code samples are available via our Help Center.

Please visit the
WP WooCommerce MailChimp support forum on WordPress.org for basic support and help from other users. Since this is a free plugin, we respond to these as we have time.

Dedicated support will is available for WP WooCommerce MailChimp Pro customers.


All development for WP WooCommerce MailChimp is handled via GitHub. Opening new issues and submitting pull requests are welcome.

Our public roadmap is available on Trello. We’d love it if you vote and comment on your favorite ideas.

You can also keep up to date with WooCommerce MailChimp Pro development by subscribing to our newsletter.

Also, if you enjoy using the software we’d love it if you could give us a review!


  • WooCommerce Mailchimp general settings screen.
  • WooCommerce Mailchimp troubleshooting screen.


  1. Upload or extract the woocommerce-mailchimp folder to your site’s /wp-content/plugins/ directory. You can also use the *Add new- option found in the *Plugins- menu in WordPress.
  2. Enable the plugin from the *Plugins- menu in WordPress.


  1. Go to WooCommerce > Settings > Mailchimp
  2. First, paste your MailChimp API Key to get started.
  3. Select whether you want customers to be subscribed to your Mailchimp list after order creation, order processing or order completion (there’s a difference in WooCommerce).
  4. Next, select your Mailchimp list and select any interest groups (optional).
  5. Select your opt-in, double opt-in settings and hit Save changes.
  6. That’s it, your WooCommerce store is now integrated with Mailchimp!


13 Հոկտեմբերի, 2021
Great plugin! I had a little issue but they fixed it immediately. Awesome support guys, keep up the good work Thank you, Nico
27 Մայիսի, 2021
Had an issue with the plugin (which was my fault) due to some settings that I had changed at MC end. Adam was EXTREMELY helpful and spent around 2 hours with me on live chat ensuring the issue was fixed and then retrospectively updating tags on products that had been lost due to the error. Adam saved me a LOT of time and effort adding tags manually and his support was second to none. Aside from the support the plugin itself is great for managing subscribers and categorising with tags etc….
20 Նոյեմբերի, 2019
I’ve used the basic version for 2 years now and it has worked perfectly. The plugin is simple to use and set up, and it has done the job I needed it to. I’m now at the stage where I need the paid version and I hope it continues to perform.
26 Հուլիսի, 2019
I have tried out a lot of WordPress WooCommerce MailChimp integration plugins and this one by far is my favorite. It goes well beyond a simple checkbox on checkout and provides a rich feature set for subscribing customers to MailChimp interest groups, adding tags, and allowing product-based list subscriptions. The settings screens are intuitive and well documented. And I am really happy about the Pro version that provides an extra level of customization and top-notch support. Keep up the good work!
5 Մարտի, 2019 1 reply
Worked fine for a while, but now all names are a mess. The encoding is not working for Japanese. It used too, and every other plugin handles names fine. Just this one doesn’t. Having to use Zapier and their expensive woocommerce plugin as a workaround.
Read all 35 reviews

Contributors & Developers

“WP WooCommerce Mailchimp” is open source software. The following people have contributed to this plugin.


“WP WooCommerce Mailchimp” has been translated into 4 locales. Thank you to the translators for their contributions.

Translate “WP WooCommerce Mailchimp” into your language.

Interested in development?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.


2.4.12 — Aug 10, 2023

  • Support for WooCommerce HPOS (High Performance Order Storage).
  • Bump WC tested version up to 8.0.1.
  • Bump WP tested version up to 6.3.

2.4.11 — Jul 20, 2023

  • PHP 8+ exception bug fix — check if array key exists.

2.4.10 — Jul 19, 2023

  • Bump WC tested version up to 7.9.0.
  • Bump WP tested version up to 6.2.2.

2.4.9 — Mar 10, 2022

  • Bug fix for to check for WP_Error.

2.4.8 — Oct 12, 2021

  • Bug fix for tags not passing to Mailchimp.

2.4.7 — Oct 6, 2021

  • Update to pass skip_merge_validation argument when subscribing users.

2.4.6 — Oct 5, 2021

  • Enhance error logging.

2.4.5 — Oct 5, 2021

  • Only send merge fields if not empty.
  • Bump WC tested version up to 5.7.1.
  • Bump WP tested version up to 5.8.1.

2.4.4 — May 26, 2021

  • Fix typo.

2.4.3 — May 26, 2021

  • Replace extract with explicit retrieval.

2.4.2 — May 24, 2021

  • Tested up to WordPress 5.7.2
  • Tested up to WooCommerce 5.3.0

2.4.1 — March 27, 2021

  • Added new ss_wc_mailchimp_subscribe_customer hook to allow easier override of whether or not to subscribe the customer.

2.4.0 — March 24, 2021

  • Tested up to WordPress 5.7
  • Tested up to WooCommerce 5.1

2.3.13 — January 5, 2021

  • Bump WP and WC tested versions.
  • Fix for category interests not returning (issue #29)

2.3.12 — April 14, 2020

  • Remove explicit private variable to fix integration issue with Aero Checkout.

2.3.11 — April 8, 2020

  • Tested up to WordPress 5.4
  • Tested up to WooCommerce 4.0.1

2.3.10 — March 3, 2020

  • Increase API return limit count to 500.
  • Tested up to WooCommerce 3.9.2

2.3.9 — February 1, 2020

  • Fix for migration version detection.

2.3.8 — February 1, 2020

  • Fix for array_map (Issue #26)
  • Tested up to WordPress 5.3.2 (Issue #28)
  • Tested up to WooCommerce 3.9.1 (Issue #27)

2.3.7 — October 31, 2019

  • Fix for opt-in checkbox not displaying.

2.3.6 — October 30, 2019

  • Fix json encode.

2.3.5 — October 30, 2019

  • WordPress coding standards updates.

2.3.4 — October 29, 2019

  • Change plugin display name.
  • Sanitize post data.

2.3.3 — August 29, 2019

  • Fix ActionScheduler 2.2.5 version.

2.3.2 — August 27, 2019

  • Upgrade ActionScheduler to 2.2.5
  • Fix encoding of unicode/international characters.

2.3.1 — August 26, 2019

  • Fix tag retrieval to return tag IDs.
  • Fix migrations.
  • Tested up to WooCommerce 3.7.0

2.3.0 — July 25, 2019

  • Added support for tags on main list.
  • Improved integration with WooCommerce Mailchimp Pro.

2.2.0 — July 23, 2019

  • Bump min WC version to 3.5.0, and min WP version to 4.7.0.
  • Bump min PHP version to 5.6 in prep for WooCoommerce 3.7 requirements.

2.1.21 — July 23, 2019

  • Prep for getting list tags.

2.1.20 — July 22, 2019

  • Bump plugin version and min WP and WC tested versions.

2.1.19 — February 15, 2019

  • Update styling of opt-in checkbox.

2.1.18 — February 15, 2019

  • Add subscribe_customer param to before/after subscribe hooks.
  • Use new logging action for logging.
  • Update tested to WP 5.1

2.1.17 — February 14, 2019

  • Allow html (hyperlinks, etc.) in Opt-In Field Label.

2.1.16 — February 5, 2019

  • Force plugin version update. WordPress.org not registering the 2.1.15 release.

2.1.15 — February 5, 2019

  • Fix fatal error.

2.1.14 — February 5, 2019

  • Fix MailChimp interest group limit

2.1.13 — January 29, 2019

  • WooCommerce tested up to 3.5.4
  • WP tested up to 5.0.3

2.1.12 — May 22, 2018

  • WPML Opt-in label fix.
  • Plugin now loads after plugins_loaded action hook.

2.1.11 — April 27, 2018

  • Fix erroneous error saying can’t load lists when no interest groups for list.

2.1.10 — February 12, 2018

  • Added WooCommerce tested up to header

2.1.9 — February 1, 2018

  • Added new opt-in checkbox location for order review above cart/product table.

2.1.8 — February 1, 2018

  • Fix «Invalid argument supplied for foreach» warning in settings (Issue #21)

2.1.6 — January 26, 2018

  • Restore opt-in checkbox location and add params to filter to allow easier adjustment of its placement.

2.1.5 — January 25, 2018

  • Move opt-in checkbox before associated label

2.1.4 — December 20, 2017

  • Tested up to WordPres 4.9.1

2.1.3 — December 19, 2017

  • Small fix to show MailChimp API error message in UI.

2.1.2 — August 25, 2017

  • Fix retrieval of mailchimp lists with numeric ids.

2.1.1 — July 24, 2017

  • Fix settings default for older PHP versions.

2.1.0 — April 26, 2017

  • Added support for WooCommerce 3.0 changes.
  • Added additional options for opt-in checkbox placement.

2.0.20 — February 1, 2017

  • Added woocommerce_mailchimp_admin_email filter to allow hooking into and overriding email where error messages are sent (defaults to get_option( 'admin_email' ) ).

IMPORTANT: You must upgrade to version 2.X by December 31, 2016 as prior versions of the MailChimp API will stop working at that point.

2.0.19 — October 4, 2016

  • Fix to not send double opt-in email to existing subscribers.

2.0.18 — September 23, 2016

  • Fix for array_filter not working with lamda for some users.

2.0.15 — 2.0.17 — September 22, 2016

  • Fix for activation error running migrations.
  • Double opt-in fix.
  • Added additional hooks and filters.
  • Code cleanup.

2.0.13 — 2.0.14 — September 20, 2016

  • Added plugin compatibility checks for minimum supported versions of WooCommerce, WordPress and PHP.
  • Added explicit plugin directory to require_once calls.

2.0.9 — 2.0.12 — September 19, 2016

  • Small fix for double-loading of lists on api key change.
  • Small fix for lists not loading after initial save on new installs.
  • Small fix for new installs not loading interest groups.
  • Removed functions.php file (no longer used).

2.0.7 — 2.0.8 — September 17, 2016

  • Fix for new installs to prevent trying to run upgrade process.
  • Small fix to not end WooCommerce Settings section with no api key or list is present.

2.0 — 2.0.6 — September 16, 2016

WARNING: This release contains breaking changes to the plugin’s action hooks and filters. If you have custom code that hooks into the plugins action hooks and filters, please review the breaking changes below to know how to update your code appropriately.

Breaking Changes

  • Action filter ss_wc_mailchimp_subscribe_merge_vars is now ss_wc_mailchimp_subscribe_merge_tags
  • MailChimp Groups now have their own action filter ss_wc_mailchimp_subscribe_interest_groups
  • Action filter ss_wc_mailchimp_subscribe_options has changed due to changes with the MailChimp API v3.0.
    • The key listid has been changed to list_id in the $subscribe_options parameter
    • The vars key has been removed from the $subscribe_options parameter (this key previously contained the merge tags and groups together).
    • The update_existing, replace_interests and send_welcome keys have been removed from the $subscribe_options parameter since they are no longer supported by the API.
    • The plugin now always updates existing subscribers if they exist.
    • The plugin now always appends interest groups and does not affect existing groups on subscribers.
    • The send welcome email can be configured on the target list and is not required to be sent through the API.
    • A new key merge_tags has been added and includes the $merge_tags array to be sent to the MailChimp API
    • A new key interest_groups has been added and includes the $interest_groups array to be sent to the MailChimp API


  • Added ability to pick MailChimp Interest Groups from drop-down list.
  • Upgraded MailChimp API to v3.0


  • Added Debug Log setting to enable/disable logging for troubleshooting purposes.
  • Added System Info setting for troubleshooting purposes.
  • New action hook ss_wc_mailchimp_loaded fired after the plugin has loaded.
  • New action hook ss_wc_mailchimp_before_opt_in_checkbox fired before opt in checkbox is rendered.
  • New action filter ss_wc_mailchimp_opt_in_checkbox allows for overriding opt in checkbox rendering
  • New action hook ss_wc_mailchimp_after_opt_in_checkbox fired after opt in checkbox is rendered.


  • Fixed issues with translations and text domains not loading properly.
  • Change list function to get_list to prevent PHP error
  • Fix issues with PHP version < 5.5

1.3.9 — September 13, 2016


  • Rename MCAPI class to prevent collisions with other plugins.

1.3.8 — September 9, 2016


  • Tested up to WordPress 4.6.1
  • Tested up to WooCommerce 2.6.4
  • More flexible opt_in checkbox placement
  • Pass $order_id to ss_wc_mailchimp_subscribe_options hook


  • Use only one instance of MCAPI
  • Fixed Issue #14 MCAPI constructor style
  • Fixed Issue #15 mailchimp_api_error_msg
  • Fixed Issue #16 where lists wouldn’t show up until you saved the settings twice

1.3.7 — December 16, 2015


  • WordPress 4.4 Compatible
  • WooCommerce 2.4.12 Compatible


  • API response not shown in debug log
  • Use only one instance of MCAPI

1.3.6 — February 9, 2015


  • Backout of change to use WC_Logger due to fatal error

1.3.5 — February 6, 2015


  • Change to use WC_Logger instead of error_log
  • Updated pot file
  • Added French translation
  • General code syntax cleanup


  • Fix for undefined variable list and array_merge issue.

1.3.3 & 1.3.4 — January 16, 2016


  • Fix enabled check. Issue #6.
  • Fix for transient key length.


  • Tested with WordPress 4.1

1.3.2 — November 4, 2014


  • Fix for headers already sent message. Tested with WordPress 4.0 and WooCommerce 2.2.*

1.3.1 — April 3, 2014


  • Fix for MailChimp merge vars bug introduced in v1.3

1.3 — April 1, 2014

Breaking Changes

  • Action filer ss_wc_mailchimp_subscribe_merge_vars now passes $order_id param to enable retrieving additional order info/meta to use in MailChimp merge vars


  • Small fix to order_created subscribe event to work with PayPal Payment Gateway

1.2.6 — February 28, 2014


  • Added additional debug logging when WP_DEBUG is enabled

1.2.5 — February 27, 2014


  • Bug fix for subscribe when not using opt-in display field

1.2.2, 1.2.3 & 1.2.4 — February 22, 2014


  • WooCommerce 2.1 fix for order custom fields
  • Fixed plugin settings link for WooCommerce 2.1
  • Bug fix for subscribe

1.2.1 — February 13, 2014


  • WooCommerce 2.1 integration: Change to use wc_enqueue_js instead of add_inline_js
  • WooCommerce 2.1 integration: Change to support new default checkout field filter for default opt-in checkbox status

1.2 — January 10, 2014


  • Added new setting to control whether or not the double opt-in checkbox is checked/unchecked by default on the checkout page.
  • Added new setting to control display location of the double opt-in checkbox (under billing info or order info)
  • Small modification to append to MailChimp interest groups for existing users so that group settings are not lost for users who were already subscribed.
  • Preparations for i18n (Internationalization) support. Several users have already asked and offered to translate the plugin into other languages. We had always planned on that, but now are making that a reality.

1.1.2 & 1.1.3 — January 2, 2014


  • Update to REALLY address issue with subscriptions not occurring on order create «pending»


  • Minor action hook change since order meta (needed for MailChimp API call) is not yet available on ‘woocommerce_new_order’ hook

— January 2, 2014

1.1.1 — December 31, 2013


  • Update to address issue with subscriptions not occurring on order create «pending»

1.1 — November 12, 2013


  • Add the option to display an opt-in field on checkout

1.0.2 — October 16, 2013


  • Minor text and comment changes

1.0.1 — October 11, 2013


  • Added «Settings» link on the Plugins administration screen

1.0 — October 10, 2013

  • This is the first public release.