MailChimp for WooCommerce Memberships

Overview ↑ Back to top

MailChimp for WooCommerce Memberships gives you the ability to sync your members from WooCommerce Memberships to a MailChimp list of your choice.

When you connect your site to MailChimp, this plugin will ensure all member data remains synced to MailChimp, letting you segment your mailing list by membership type, status, and more!

This plugin requires WooCommerce Memberships (purchased separately) to function.

Installation ↑ Back to top

  1. Download the extension from your WooCommerce dashboard
  2. Ensure your store meets the plugin requirements.
  3. Go to Plugins > Add New > Upload and select the ZIP file you just downloaded
  4. Click Install Now, and then Activate
  5. Click the Configure link, or go to WooCommerce > Memberships, and read the next section to learn how to setup and configure the plugin.

Requirements ↑ Back to top

  • WooCommerce 2.6.14 or newer
  • WordPress 4.6 or newer
  • PHP 5.3 or newer (you can see this under WooCommerce > Status)
  • WooCommerce Memberships 1.9.0 or newer

Setup & Configuration ↑ Back to top

This guide will assume you’ve already configured WooCommerce Memberships.

Settings for this plugin can be found under WooCommerce > Settings > Memberships > MailChimp Sync. Here, you’ll enter your API key for your MailChimp account, then configure how member data should be tied to MailChimp.

WooCommerce Memberships MailChimp Sync: new settings

Get MailChimp API key ↑ Back to top

First, we need to get your API key from your MailChimp account, as this will let the plugin pull in data about your lists. You can find this by clicking “Account” from your menu while logged in.

MailChimp for WooCommerce Memberships: Get API Key, step 1

Next, click “Extras”, then API Keys, to view any API keys for your account, or create new ones.

MailChimp for WooCommerce Memberships: Get API Key, step 2

Finally, if you have an API key already, you can use your existing key, or generate a new one (we recommend using a new key). Then, copy this key.

MailChimp for WooCommerce Memberships: Get API Key, step 3

Paste your API key into the plugin settings, and save your settings. You’ll then be able to configure plugin settings with access to your MailChimp lists and merge tags.

Extension settings ↑ Back to top

Under WooCommerce > Settings > Memberships > MailChimp Sync, once you’ve saved a valid API key, you’ll now see data related to your MailChimp account.

The first thing to do is to select the list your members should be synced to, and save your settings. When you’ve selected your list, the plugin will automatically push new merge tags to your MailChimp Account. You’ll have one merge tag per plan, along with an ISACTIVE merge tag.

MailChimp for WooCommerce Memberships: Merge tags created
Automatically added merge tags

You can now map merge tags to your existing membership plans. You can use the tags the plugin has created for you, or select merge tags of your own (in case you’ve already had member data present in MailChimp).

MailChimp for WooCommerce Memberships: List settings

To see more details on what each merge tag represents, please view our notes on MailChimp segments. These merge tags are automatically updated every time a membership is changed to ensure that status and member data are always up-to-date in MailChimp.

Other settings

MailChimp for WooCommerce Memberships: Signup settings
Signup settings
  • Enable Debug Mode – enable if you experience issues with your MailChimp connection; as a best practice, this should be disabled unless actively troubleshooting.
  • Members Sign up – Determine if members are signed up for your list automatically, or if they must opt into your list. Please see our overview below on whether or not opt in is required.
  • Members Signup Prompt Text – Enter the text to use for opt in at checkout and from the members area if a member has not opted into your list.
  • Members Signup Button Text – Enter the call to action text for the members area opt in.

Finally, you can configure some general settings for how to handle certain membership events.

MailChimp for WooCommerce Memberships general settings

  • Deleted memberships – Determine whether deleting a user membership unsubscribes the member from your list, or removes the member from your list. If the member has more than one membership, the member will only be removed or unsubscribed if all memberships have been deleted (though merge tags will still be updated to reflect accurate membership data).
  • Deleted plan merge fields – Determine what to do with plan merge tags if a plan is deleted. You can keep existing merge tags in MailChimp, or delete those merge tags when plans are deleted.
  • Sync members – This action forces a member sync with MailChimp — helpful if you’ve just installed, or had your site in maintenance mode and need to update membership records.

MailChimp usage ↑ Back to top

Do I need consent to add members to my list? ↑ Back to top

This depends entirely on what kind of emails you’ll be sending to this list. Are you sending emails related to the membership perks and content available? Or related to the lifecycle of this person’s membership? If your emails are for the purpose of fulfilling a contractual obligation, legal obligation, or for a legitimate business interest, you likely do not need consent. Jilt has a great overview of the GDPR and email marketing that we’d recommend reading in order to determine how your own business should comply with privacy regulations like the GDPR and PECR.

MailChimp segments ↑ Back to top

As changes happen to membership data on your site, these changes are automatically synced with MailChimp so your subscriber data is always updated. The following events will update your subscriber data in MailChimp:

Event Plan merge tag changes Other changes
Membership created or purchased plan merge tag updated to reflect membership status Subscriber added if not previously on list; ISACTIVE – updated to “yes” when plan access activated
Membership expires or is cancelled plan merge tag – updated to reflect membership status ISACTIVE – updated to “no” if there are no other active memberships
Membership is transferred plan merge tag is deleted from subscriber If there are no other memberships, member is unsubscribed
Membership is deleted plan merge tag deleted from subscriber If there are no other memberships, member is unsubscribed or removed (depending on settings)
Membership status changes plan merge tag always reflects current status ISACTIVE may change depending on all user memberships’ statuses

In short, you’ll always have a plan merge tag updated with the current membership status (such as “active”, “pending”, “expired”, etc), as well as an ISACTIVE merge tag that is updated to reflect whether the subscriber has any active membership on your site (will always be “yes” or “no”).

MailChimp for WooCommerce Memberships subscriber data
Subscriber membership data

This helps you create segments in MailChimp so you can target emails to particular members, all members, or members with specific statuses.

MailChimp for WooCommerce Memberships create segment

MailChimp only allows for up to 5 segmentation conditions, so the ISACTIVE tag can be very handy to target multiple plans at once.

Here are a couple general rules to help you create segments:

  • The ISACTIVE merge tag will be empty if the subscriber has no membership records on your site. It will be “yes” if they have any active memberships, and “no” if they have had memberships that have since become inactive.
  • The plan-specific merge tags will always have the current status as the value of the merge tag (here’s a quick reference list). The plan-specific merge tag will be empty if the subscriber has no memberships for that plan (active or inactive).

Admin Usage ↑ Back to top

For the most part, you’ll never have to push a member sync to MailChimp after set up, as the plugin will do this automatically. Once you’ve set up your list and merge tags, we do recommend using the “Sync now” action in settings to push your membership data to MailChimp.

If you find that you want to force data to update at any time, you can do so from the plugin settings, or from your “Members” list via bulk action or single membership action.


MailChimp for WooCommerce Memberships bulk actions

MailChimp for WooCommerce Memberships single actions

Your plans list will also have merge tags displayed for quick reference if you’re building segments.

MailChimp for WooCommerce Memberships plan list

Note that merge tags are not editable from the plan view; they can only be edited via plugin settings. We do not recommend changing merge tags once you’ve started syncing members. If you do, please perform a full sync from the plugin settings so MailChimp data is accurate.

Customer experience ↑ Back to top

For most stores, customers will not see anything on the frontend of your site while using this plugin. However, if you’ve enabled opt-in for members (after reviewing our notes on privacy / opt-in), then your customers will see opt-in prompts in two locations:

At checkout while purchasing a membership as a guest, or while logged in as a member:

MailChimp for WooCommerce Memberships: checkout opt-in

In the members area of their account if they haven’t opted in:

MailChimp for WooCommerce Memberships: members area opt-in

Members can unsubscribe from your emails when sent.

Frequently Asked Questions ↑ Back to top

Q: Can I remain GDPR-compliant while adding members to my list?
A: Yes! It depends on the basis you have for sending those emails, and what kind of emails you’re sending. Please review our notes on privacy to determine what’s best for your site.

As for personal data erasure requests, these are handled by the main memberships plugin, along with your settings for deleted memberships. Please review the Memberships privacy details for further information.


Q: What will happen if I delete or expire a membership, but the customer still has other active memberships on my site?
A: When there’s a change to expire or remove one membership, other memberships are also checked before pushing data to MailChimp. In this case, since the customer has other active memberships, they won’t be removed or unsubscribed, and your “Is active” merge tag will remain “yes”. The membership being deleted will have its plan merge tag cleared in this case only to reflect there is no longer member data for that plan.


Q: I have a lot of plans, and I want to target active members of some of them, but I don’t have enough segmentation conditions. How can I do this?
A: Unfortunately you may be limited by the segmentation options within MailChimp if you have several plans you want to target in a segment. When this happens, we recommend creating a segment for each plan, then duplicating your campaigns to segment for different plans with the same content so you can reach your intended audience.

Troubleshooting ↑ Back to top

Having difficulty with the plugin? Please ensure your site meets the plugin requirements, and if so, get in touch with the support team for assistance.

Questions & Support ↑ Back to top

Have a question before you buy? Please fill out this pre-sales form.

Already purchased and need some assistance? Please check out our troubleshooting tips for common issues, or get in touch with support via the help desk if you require further assistance.

WooCommerce - the most customizable eCommerce platform for building your online business.

Back to the top