Upgrading to 4.0

Version 4.0 of MailChimp for WordPress does not come with many visible changes, but it is undoubtedly the most important update since we've started working on the plugin 4 years ago.

This update upgrades you from the older MailChimp API (a server the plugin "talks" to) to their most recent API version. MailChimp's older API will no longer be operational at the end of 2016, so we are forced to follow along.

It is important that you update the plugin to version 4 before December 31, 2016. MailChimp will completely remove their old API at that point.

Don't worry though, this change will allow for a lot of great stuff later on.

What changes for you

MailChimp made a lot of changes, even completely removing certain functionality.

This means we had to make some changes as well, although we really tried to keep things to a minimum. Make sure to read the following list of changes to ensure things will keep on working as expected on your site.

Send Welcome Email

MailChimp removed the "send welcome e-mail" option from their API. This feature is now handled from within your list settings in MailChimp only.

You can find this setting by logging in to your MailChimp account and then going to Lists > Your List > Settings > List Name & Defaults.

List Name and Defaults for [Test] Your List Name | MailChimp 2016-07-26 15-02-16

Please note that the final welcome e-mail is only sent if you have enabled double opt-in.

Grouping fields

In the new MailChimp, groupings are now called "interests". This brings along some related (technical) changes, including a new and hopefully easier data format.

If you are using grouping fields in your form, we highly recommend re-adding them to your form code through the "available fields" buttons at the top of your form editor.

Form Fields - MailChimp for WordPress

Filter hooks

Some of the available filter hooks in the plugin were renamed or deprecated. While backwards compatibility is taken care of, we recommend you update your custom code to the new hook names.

Old New
mc4wp_merge_vars
mc4wp_form_merge_vars mc4wp_form_data
mc4wp_integration_merge_vars mc4wp_integration_data

E-Commerce

Our premium eCommerce360 integration will keep on using the older API versions for now. We are releasing a new e-commerce plugin a few weeks from now. All existing customers with a valid license key will automatically receive this new plugin, free of charge.

Questions? We're here to help

Should you have any questions about the update to version 4.0 or the plugin in general, don't hesitate to let us know. We are here to help and guide you trough the update process.

PS. As usual, you can download the update from WordPress.org. If you're not seeing an available update in your WordPress Admin, please deactivate the plugin and click the "Check Again" button on the updates page.

Was this article helpful? ·