Configuration guide

  1. Enable the module.

  2. Click the Get API Credential button and place your MainChimp credentials.

  3. Enter the API key in the API key list field. It should update automatically and let you select an API key from the dropdown menu below (if not, just click on anywhere in the page outside the textbox, that should do the trick and update the dropbox menu)

  4. Save the Configuration. If you already had a Mailchimp store created you can skip steps 4 to 8.

  5. On your magento admin go to Mailchimp > Mailchimp Stores


  6. Click on Create New MailChimp Store.

  7. Fill all the required fields on General and on Address.

  8. Save the configuration.

  9. On your magento admin go Go to Mailchimp > Configuration

  10. Select the store created on the drop down list.

  11. Enable Ecommerce data in order to send Customers, Orders and Products as well. Ecommerce

  12. If you want to send Abandoned Carts as well, make sure to enable it and to have Ecommerce section enabled as well.

    Abandoned Carts
  13. Save the configuration.

Create a field-mapping/mergefield in the audience

    First you have to create it on Mailchimp and then you will see it on Magento (once you configure an API Key). By clicking in "add" in Magento, then you will see two columns, first one references to Mailchimp and the second one references to Magento, they have to be the same. In the left is the customer info and in the right is the value it will assign it. In this case we will use date of birth 

Other things to consider:

a. Cronjobs: Mailchimp for Magento 2 requires the Magento cron to be set up an running, without this the extension can't work because it relies on this to synchronize data.

See more at:

b. Syncing from Mailchimp to Magento: Even though the main function of the extension is to sync data to Mailchimp, you can also sync subscriber information from Mailchimp to Magento. This on top of requiring a cronjob task to run, it requires a webhook for your configured list so that Mailchimp can communicate with your site when it has updated information for the subscribers. If the webook wasn't automatically created for your Mailchimp list (you can check this on your Mailchimp account, going to your list, then to Settings>Webhooks), you can create it on the Mailchimp extension settings in Magento using the "Create Webhook" button that appears when you enable 2-way sync. You need version 1.0.28 or higher to have this available.

c. Domains and multistore: Have in mind that as of recently, Mailchimp has made some modifications to the API, and now each store you have connected to Mailchimp must have its own domain. Meaning that if you have a multistore Magento where the extension is configured either at the website or storeview level for multiple-stores, each store must have its own domain in one of the following ways, even if the only difference is the language.


Store 1:
Store 2:

Read the following article (Step 6) on how to add a store code: