Migrating from MailChimp to MailPoet

You've made the best choice and switched to MailPoet? Congrats! Now to get you started on migrating those subscribers. We won't cover the general setup of MailPoet as that is already covered in the rest of our documentation.

Migrating takes less than 10 minutes and can be completed in two simple steps.

There are two methods of importing from MailChimp. You can either export the subscribers from your MailChimp account and import the CSV file. Alternatively, you can import directly from MailChimp using an API key. Both methods are covered below.

Step 1: Exporting your MailChimp Subscribers

In MailChimp click on Lists

From the Lists overview screen, select the list you want to export subscribers from.

MailPoet imports any custom fields contained in the CSV export from MailChimp. If you don't want these fields in the export, click on Toggle Columns in the list and deselect the fields you don't want in the export.

Click Export List MailChimp sends an email with the download link once the export is ready.

MailChimp exports a .zip file. It contains 3 CSV files. One for subscribed users, one for cleaned users and one for unsubscribed users. Importing into MailPoet you only need the subscribed CSV file. Do not use the others.

Step 2: Importing into MailPoet

Go to your wp-admin > MailPoet > Subscribers > Import Select Upload a file and select the subscribed CSV from the zip.

Click Next step, you'll then get the option to check the import and assign fields. By default, any custom fields are set to Ignore Field. If you click on Ignore Field, you can then either create a new custom field in MailPoet with the name or map the value to an existing custom field.

Set the list and click Next Step.

All being well you'll see a success message;

Method 2: Importing via the API

MailPoet allows you to connect directly to the MailChimp API to import subscribers, for this, you'll need to generate a MailChimp API key.

Step 1: Connecting the API

Once you have your MailChimp API key, go to your wp-admin > MailPoet > Subscribers > Import and select Import from MailChimp Enter your API key and click Verify.

Step 2: Importing Lists

Select which list you want to import from MailChimp.

You can select multiple lists to import. Once you've selected your lists click Next Step.

Check the import and assign fields. By default, any custom fields are set to Ignore Field. If you click on Ignore Fields, you can then either create a new custom field in MailPoet with the name or map the value to an existing custom field.

Now just set the list and click Next Step.

All being well you'll see a success message;