MailChimp Add On Documentation

MailChimp can be an extremely powerful tool for communicating with and retaining your customers.  The  EDD MailChimp extension allows you to subscribe customers to specific email lists for later communication while following the MailChimp rules for adding people to lists.

Configuring the MailChimp Add-On

To configure the MailChimp Add On you will need to complete its settings.

  1. Log into the WordPress Admin area
  2. Navigate to Downloads → Settings and click on the Extensions tab
  3. Then click on the Mailchimp link right under the tabs.
  4. Fill out the appropriate fields
    1. The MailChimp API Key must be acquired from
    2. Log into the MailChimp account you want to connect to this Add On
    3. Navigate to Account | Extras | API Keys & Authorized Apps
    4. Click the "Add A Key" button
    5. (Optional) Edit the "Label" to something relevant such as "EDD on <>"
    6. Copy the API Key.
  5. Return to the MailChimp Settings in your WordPress dashboard and paste/enter the MailChimp API key into the MailChimp API Key field.
  6. Click the "Save Changes" button at the bottom of the page. This will allow the MailChimp Add On to retrieve the mailing lists from MailChimp.
  7. Choose whether or not to "Show Signup On Checkout." When selected, this option output a checkbox on the checkout page giving the customer the option to sign up to the mailing list selected in step 13 (below).
  8. Add a short, appropriate description of the checkbox in the "Checkout Label" field. If left blank, the buyer will see "Signup for the newsletter".
  9. Select "Double Opt-In" if you would like customers to receive a verification email before being subscribed to your mailing list.
  10. Select "Replace Interests" if you'd like your customers' interest groups to be replaced in MailChimp when they make a purchase. Interest Groups in MailChimp are one way you can choose to target emails to specific customers. For example, using interest groups, you could send emails only to customers who are interested in "Product A". The way this extension works is that if a customer purchases "Product A" from your store, their interest groups will include "Product A" alongside any other products they have purchased. But if you select the "Replace Interests" option, any other products they've purchased will be removed from their interest groups, as opposed to simply adding "Product A" alongside those other interests. 
  11. If you want to include test (as well as non-test) purchase information to MailChimp, check the option called "Record eCommerce Data in Test Mode". Note that by default, purchase information is sent to MailChimp so that you can send emails to specific customers. For example, you could send emails to "First-time purchasers" only within your MailChimp dashboard. 
  12. Connect a list
    1. Under "Available Lists" choose which lists you'd like to connect. Only lists that have been connected can be used with Easy Digital Downloads. Click the checkbox next to each list you'd like to connect.
    2.  Click "Save Changes" at the bottom of the screen. This will connect those lists from MailChimp to your store. 
    3. When the page reloads, you'll see the lists you chose to connect listed under "Connected Lists".
    4. Note: if you do not see any lists here, it's possible that you haven't created a list in MailChimp yet. Create a list there first. 
  13. Choose a default list. Under "Connected Lists" the first column shows which list is the default list. This list is the one that will be used at checkout when customers choose to join the list. 

Per-product Mailing List Settings

You can also choose one or more MailChimp mailing lists you'd like a customer to be subscribed to when they purchase a specific product. Do this by going to the product's edit screen and selecting the list(s) you wish customers to be added to in the "MailChimp" box. In this section, you can also select whether to subscribe customers to specific groups within the list. If a list has one or more groups, the group(s) will be shown as an additional checkbox that is indented below the main list name, like this:

The per-product mailing list settings are separate from the default list setting you configured previously. The per-product mailing list settings do not output a checkbox anywhere or require that the customer opt into the mailing lists. The act of purchasing the product automatically adds customers to the lists.

Note that the groups under the lists come from the groups you create for the list in your MailChimp account. Learn more in  MailChimp's documentation on list groups

Syncing Sales Data

If you install this extension when you already have customers, and you'd like to get past data into your MailChimp lists, you can use the Force Sync option. Go to Downloads → Settings → Extensions → MailChimp → Connected Lists and find the list you wish to sync.

By clicking "Force Sync Now", it will sync all of your store's purchase data into your MailChimp account so that you can send targeted campaigns out to specific types of customers in your shop - right from within your MailChimp Dashboard. To learn more about MailChimp's targeting options based on sales data, see  this document

Note: When doing the import, a tag will be created on the user at MailChimp indicating what product was purchased.

Note: Importing sales data does not add users to your email lists. It only imports the sales data for your existing subscribers and connected them together. For example, if User A is already on your list in MailChimp and then makes a purchase on your store, MailChimp will learn that User A made a purchase. This way you can target emails to "First-time purchasers" for example. 

Note: If your store makes more than 1,000 sales a month, we recommend not doing more than a month at a time to avoid exceeding MailChimp's max number of API calls in a given timeframe.

Note: Usually, if one of your MailChimp campaigns caused a user to purchase a product from your digital shop, the purchase will be logged in your MailChimp campaign report letting you know. However, if the customer does not have the MailChimp browser "cookie", the purchase will not be logged in MailChimp. Here are a few possible reasons this could happen:
- The customer has cookies blocked in their browser
- The customer cleared their cookies after clicking the link in your campaign
- The customer clicked the link in your campaign but closed their browser and purchased using a direct link later
- The customer used a different computer or browser to complete their purchase
- Any other reason the cookie might not exist will cause the purchase to not be logged in MailChimp.


Why can't I see my new MailChimp lists in WordPress?
The extension only retrieves lists from MailChimp every 4 hours (approximately). This is to prevent your site from contacting MailChimp too often. To force refresh your lists, go to Downloads > Settings > Extensions and click Save Changes.

Why aren't users being signed-up at checkout?

If you have set up anything that causes the customer to bypass the "normal" checkout screen, they won't be added to the 'Checkout' MailChimp list based on your default MailChimp settings. A few examples of this would be " Buy Now" buttons via Stripe CheckoutPaypal, or any other checkout-bypassing setup. 

If you are using the  Free Downloads extension and you want your users to be subscribed to MailChimp when downloading, make sure to check the "Display Opt-In" setting under Downloads → Settings → Extensions (tab) → MailChimp (section).

If my store is set to bypass the checkout screen, will customers be subscribed to the MailChimp per-product mailing lists?

Yes. They will be signed up to per-product mailing lists (see "Per-product Mailing List Settings" above). However, they will not be signed up to the "Checkout" list specified under Step 8 above.

Integrate Free Downloads with MailChimp to grow your Email List: