New WordPress Plugin: WooCommerce MailChimp

The WooCommerce logo and MailChimp logo are trademarks of WooThemes and MailChimp respectively.

The WooCommerce logo and MailChimp logo are trademarks of WooThemes and MailChimp respectively.

After a frustrating and fruitless search for a simple and free solution to basic WooCommerce integration with MailChimp, I decided to sit down and write a little plugin to do just that. There are a couple of paid solutions, but, in my opinion, most are overpriced for providing such vanilla functionality. Also, it seems this functionality was previously bundled with WooCommerce and WooThemes has since removed it and made it a paid “extension.”

So, without further ado, here is my new WooCommerce MailChimp plugin for WordPress:

WooCommerce MailChimp provides simple MailChimp integration for WooCommerce.

Easily add customers to a designated MailChimp list and, optionally, MailChimp interest groups upon order creation or order completion.

Double opt-in option for anti-spam compliance.

The plugin is now on the WordPress Plugin Repository and you can get it by clicking on the following link:

Download WooCommerce MailChimp

Get the Source on GitHub

Join our Trello Board to see what’s on our roadmap and vote on features. As always, please provide your feedback and/or enhancement requests here.


WooCommerce Event Selection

  • Subscribe customers to MailChimp after order creation
  • Subscribe customers to MailChimp after order completion

Works with MailChimp Interest Groups

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


  • All features should work for each blog in multisite installations but this has not yet been tested.


Feedback is welcome!

If you need help, have problems, want to leave feedback or want to provide constructive criticism, please do so here at the WooCommerce MailChimp plugin page.


Follow @anderly on Twitter for updates on this and other plugins.


  • English (default)
  • No other translations yet.

Thanks in advance for your help on any translation efforts!


  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 > Integration > MailChimp
  2. First, enable the plugin and set your MailChimp API Key and hit save.
  3. Select whether you want customers subscribed to your MailChimp list after order creation or order completion (there’s a difference in WooCommerce).
  4. Next, select your MailChimp list and set any interest group settings (optional) and hit save.
  5. That’s it, now customers who purchase products from your WooCommerce store will automatically be subscribed to the selected list (and optional interest groups) in MailChimp!


  1. WooCommerce MailChimp options screen.
  • Ivette

    Hi Adam,
    I am really interested in using the plugin. Can customers be automatically be added to a list, without giving them option to optin at check out etc….

    • Yes, this is possible. You can have them automatically subscribed to a list or give them a checkbox that allows them to opt-in. You can also control whether it’s checked by default or not.

      • Ivette

        Thanks so much for the quick reply. Have you released the paid version of this plugin?

  • Bob

    I keep on getting the following error sent to me from my wordpress installation: “WooCommerce MailChimp subscription failed: MMERGE3 must be provided – Please enter a value (250)”. Your plugin doesn’t seem to have a mapping feature to map WP/WooCommerce values to MailChimp. Is that the issue? Thanks, Bob

    • Bob,

      That error indicates you have a merge field named MMERGE3 defined in MailChimp that is required. The plugin currently only supports the MailChimp default merge fields of EMAIL, FNAME and LNAME. The upcoming 2.0 version will include a mapping interface.

      Until then, you could either make the merge field optional in MailChimp or rename it to one of the defaults I listed above if it isn’t already defined.

      Hope that helps and stay tuned for version 2.0 coming in October.

      • diomerortiz

        Hi Adam,

        Just checking in on the subject of the “MMERGE3 must be provided – Please enter a value (250)” error. We are currently running version 1.3.7 on our WP install and keep getting that error. Were you ever able to patch this up?

        • We haven’t finished the 2.0 version yet as we are working to update the plugin to use the latest version of the MailChimp API. The quickest fix would be to login to MailChimp and either make your merge field “MMERGE3” not required or change it to one of the standard fields. By default, the plugin expects the default merge fields of EMAIL, FNAME and LNAME.

          • diomerortiz

            Thank you for the fast response and the idea of the standard field workaround. Hopefully that helps.

  • Henry Keskinen

    Hello 🙂
    Thanks for this plugin. This is something that really helps me. But, I cant get this working. API key is ok ‘cos I can choose the list but it just wont work somehow. Can you help me, is there anything to try? I’m using multisite, WP 4.3.1 and WC 2.4.6.

  • Tina Academia

    Hi Adam,

    We really love your plugin integrated in our website. WooCommerce MailChimp Version 1.3.1 is installed into our WordPress 4.2.5.
    Lately we are getting errors where in customers are subscribed into a wrong mail list after order has been created which happened twice already. I’ve noticed that there is a warning – ‘This plugin has not been tested with your current version of WordPress’.
    Can you please help us resolve this problem? We really wanted to continue using the plugin however we got 2 customer complaints because of this.
    Thanks heaps in advance!

  • Alex Nitsa


    How to check if the user is registered or not? Thank you

  • David Storer

    Hi Adam, I am loving this plugin and it is exactly what I have been looking for to customise my post sale communications.

    I have been using the following video as a tutorial but something is not working for me, I was hoping you could help out.

    I have installed the plugin and integrated it using the API key but when I go to ‘products’ the mailchimp integration on the right hand side is not there. (3:22)

    Have you come across this at all?

    If so, how can I fix the problem please.

    Thank you


  • Hi,

    Im having trouble with translation.

    I translated POT file (Croatian) and uploaded PO and MO files to wp-content/plugins/woocommerce-mailchimp/languages but with no luck.

    I tried renaming those files in various ways, and nothing…


    …thise are the files name combinations I tried…

    • wp-content/languages/plugins

      but still no translations…

  • Alex Fearnside

    Hi Adam, great work on MailChimp plug in, thank you.

    I’m looking forward to Version 2.0.


  • Gareth Martin

    Thanks for the plugin Adam!

  • Hi Adam, thanks for your work on this plugin. My store hadn’t tested its use yet, when I upgraded ContactForm7 and was asked to validate 2 forms, and I got the following error:
    Warning: Invalid argument supplied for foreach() in ~/plugins/woocommerce-mailchimp/classes/class-ss-wc-integration-mailchimp.php on line 358

    So I looked at WooCommerce integration and see that your plugin is not seeing my Mailchimp List anymore. API key is still there.

    • Perhaps it is a problem at Mailchimp. I can log into my account there but then get an error when trying to view Lists.

  • Matthew Thompson

    This plugin has never worked for my site.

    The API key is correct and the option to subscribe is present at the Checkout within Woocommerce.

    As the admin I get a email from every order, saying Subscription to the List failed.

    The list exists within mailchimp…

    Any ideas..?

    • Nico Morgan

      I’m also having this problem and I’m wondering whether Woocommerce has updated something and stopped the plugin working. Have had ten orders recently and none were added to Mailchimp.
      API entered. Correct list is offered and selected.

  • Neil Thrussell

    Adam, love the plugin…. Any chance in the near future the plugin the plugin could insert the Sign Up Name and email addy to a specific group based on the purchases of a product..

    Product A goes to group A
    Product B goes to group B

      • Neil Thrussell

        It says available Q1.. so that means you have two days 🙂

        • 🙂 It may bleed into Q2, but we’re working on it. Lot of pent up demand so we want to make sure it’s right before we release it.

          • Neil Thrussell

            No worries, I hear you loud and clear. You want it right the first time.. I whole heartedly support those ethics. I personally would have it right and late that on time and not right!

          • We’ll keep you posted!

  • Greg Maldewin

    Hi Adam, We’re getting an email with the subject “WooCommerce MailChimp subscription failed”, and the message “WooCommerce MailChimp subscription failed: There is no record of “” in the database (232)”.

    Can you tell me what this means, or how to correct it?

    Thanks, Greg

    • gregor92

      Adam, any info on this?

  • Kristian Nafstad

    Hi Adam!

    I have the checkbox on the checkout site.
    When one of mye customers already have subscribed to the list, is there any way to make it “disappear” for this spesific customer, so they don’t see that button again?

  • evapavlikova

    Hello, I have got started couple of days this error: Unable to load lists from MailChimp: (-99) Could not connect (ERR 1: Operation not permitted). I assume it happend after some upgrade. Any chance to get feedback if it is general error or it is happening only to me? Thanks for feedback in advance, Eva

  • Josh Woods

    Hi Adam, I am wondering how to get the plugin to send more than just first and last name and email address to mail chimp, I would love to have it send products they purchased and their address. How can I make that happen?

  • Just what I needed Adam. Thank you!
    When using groups it seems as the supplied interest groups will overwrite any old groups that the user might have had in mailchimp previously. Is there any way to make the plugin merge the existing interest groups instead of overwriting them?
    Thanks, Mikael

    • Doh. My bad.
      I just messed up my first test, and the plugin is already doing EXACTLY what I asked for. Thanks again.

  • Lovecoms

    Hi Adam, I’m using this plugin – thanks for building. I love woocommerce, but get frustrated at paying out at each step so really appreciate this plugin.
    I have 2 levels of user on my site – paid subscriber and people who do an email signup registration. The details for paid subs are going into the MC list perfectly, but registered details aren’t getting caught. I’ve clicked box to capture details on registration page…. not sure where to go now. any help welcome

  • Simon

    Hi Adam, we’re having an issue where e-commerce data isn’t being pulled through into MailChimp campaign reports, though it being pulled through to individual subscriber reports. Everything appears to be configured correctly at both ends – any thoughts on where I should look for a solution?

  • Asterisk_Admin

    Hey Adam,

    I was just thinking I was going to have to “hack” this plugin to make it work for my needs and was VERY HAPPY to see that you had added hooks and filters in all the right places so that I could hook in and override what I needed.

    In case anyone else is trying to map additional fields from WooCommerce to MailChimp, please find my function for adding the purchase date, order total, product names, and order number to the list of Merge Vars sent to Mailchimp.

    PLEASE NOTE: your labels must match mailchimp merge field names.

  • Elea Belda Beneyto

    Hi Adam, thanks a lot for this plugin! 🙂
    It’s amazing and thank for making it for free!

    I have a little question, my site is multilingual so I would like to add my customers to different lists depending on the language. For example, if they buy in the English store they automatically go to the “clients” list, if they buy in the Spanish store they automatically go to the “clientes” list, and so on.

    Is this a feature that you may be implementing in the pro version of the plugin?
    Let me know when you can.