How to Install and Use the Mailchimp Addon with WPForms

Would you like to connect your forms to your Mailchimp account? With Mailchimp integration, you can automatically add emails to your marketing lists when your forms are submitted.

In this tutorial, we’ll show you how to use our Mailchimp addon to integrate WPForms with your Mailchimp lists.

  1. Installing Mailchimp
  2. Copying Your API Key From Mailchimp
  3. Adding Mailchimp Integration to Forms
  4. Frequently Asked Questions

Requirements: You will need a Plus license level or higher to access the Mailchimp addon.

1. Installing Mailchimp

Before we get started, be sure to install and activate WPForms on your WordPress site.

Once you’ve got WPForms installed and your license is verified, you’ll be able to quickly install and activate the Mailchimp addon.

After installing the Mailchimp addon, the next step is to integrate your forms with your Mailchimp account. To do this, navigate to WPForms » Settings and then click on the Integrations tab.

Mailchimp Integrations Tab

When you open the Mailchimp option within this tab and click the + Add New Account button, you’ll be able to see additional fields for API Key and Account Nickname.

Add new account to WPForms Mailchimp integration

2. Copying Your API Key From Mailchimp

Now that you’ve installed the Mailchimp addon, you’ll need to add your API key. The API is what allows the WPForms plugin on your site to communicate with your Mailchimp account.

Each Mailchimp account will have a unique API key. To access this, you’ll need to log into your Mailchimp account. Since you’ll be coming back to your WPForms settings later, we recommend opening Mailchimp’s site in a separate tab or window.

Once you’ve logged into Mailchimp, you’ll need to go to your Account page.

Go to Account page in Mailchimp

Within the Account page you’ll see an additional menu near the top of the page. From this menu, you’ll need to go to Extras » API keys.

Open API Keys page in Mailchimp

When you open the API Keys page, you’ll be able to copy any existing API keys. Or, if you haven’t previously generated any keys, you can create a new API key by clicking the Create a Key button.

Create and copy Mailchimp API key

After you’ve copied the key, you can return to the tab or window with your WPForms settings and paste it into the API Key field.

You’ll also need to fill out a nickname for this connection. This name will only display in the form builder (it won’t ever be visible to your users), and is meant to help if you add additional Mailchimp accounts down the road.

When you’re ready, click the Connect to Mailchimp button to save the connection.

Add API key and nickname to Mailchimp settings

Once these fields are saved, you should see a green box that says Connected.

Mailchimp integration is connected

3. Adding Mailchimp Integration to Forms

The final step is to add Mailchimp integration to specific forms on your site. To do this, you’ll need to create a form or edit an existing form.

After opening the form builder, go to Marketing » Mailchimp and click the Add New Connection button.

Add new Mailchimp connection

This will cause an overlay to appear, and here you can enter a nickname for the connection you’re creating. A nickname is useful if you plan to connect this form to more than one mailing list, and will only be visible to you – your users will never see it on your site.

Add a Connection Nickname

Once a connection is created, you can choose from any Mailchimp accounts you connected in Step 2.

After selecting an account, you can also choose a specific mailing list within that account.

Select Account and List in Mailchimp

Note: All Mailchimp mailing lists must be created in your Mailchimp account. For more details, check out Mailchimp’s tutorial on getting started with lists.

Under the List Fields section, you’ll see all of the available fields for subscribers to your Mailchimp mailing lists. The only field you’re required to fill in is Email Address.

Configure Mailchimp connection in WPForms form builder

When you click the dropdown next to Email Address, only Email fields from your form will be displayed. Go ahead and select the Email field you’d like.

This all you need to complete your connection to Mailchimp!

If you’d like to customize this connection further, please see the additional options below.

Connecting Additional Fields

To send additional entry fields to Mailchimp, you’ll need to map your form fields to any available fields in Mailchimp.

Here are the fields that Mailchimp offers for your subscribers by default:

  • Email Address
  • Address
  • Birthday
  • First Name
  • Last Name
  • Phone Number

Map form fields to Mailchimp

As noted above, the Email Address is required. However, any other fields you see are optional.

If you’d like to add more fields to your subscriber profiles, please check out our tutorial on setting up custom Mailchimp fields.

Organizing Subscribers with Groups

Within Mailchimp, you can also choose to further divide your mailing lists into Groups. If you’re not familiar with this option, please see Mailchimp’s tutorial on Groups for more details on what they are and how Mailchimp recommends using them.

If you’ve set up any Groups in the mailing list you’ve selected, those will automatically be displayed in the Select Groups section.

Optionally select Mailchimp groups

Conditional Logic

Conditional logic allows you to set rules for events based on the user’s selections in their form entry.

Set up Mailchimp Conditional Logic

For example, you could use conditional logic to allow users to choose if they’d like to be added to your mailing list.

You can also apply conditional logic to the Groups described above. If you’d like to learn how to do this, please see our tutorial on how to allow users choose which groups they get added to.

Double Opt-in

When enabled, double opt-in will prevent users from being automatically added to your Mailchimp lists. Instead, they’ll receive an email asking them to confirm their subscription. The user will only be added to your mailing list after they’ve clicked the confirmation link in that email.

Mailchimp double opt-in option

For more details, please see Mailchimp’s tutorial on using double opt-in.

Frequently Asked Questions

Why are new subscribers getting added to my list as “opted out”?

When enabled, Mailchimp’s GDPR settings will automatically uncheck the opt-in options for any new subscribers. Mailchimp and WPForms each have their own separate GDPR agreements, so even if a user agrees to the GDPR agreement on your forms, Mailchimp isn’t currently able to see this and will assume the GDPR hasn’t been agreed to (and will remove the opt-in function from the user).

You can easily fix this by disabling Mailchimp’s GDPR settings within your Mailchimp account. For more details on how to do this, please see Mailchimp’s documentation.

Why aren’t my newsletters delivering from my Mailchimp account?

Configuring Mailchimp to send newsletters “from” free email service providers accounts, specifically Yahoo and AOL, can and will result in email delivery issues. For more details, please contact Mailchimp’s support team.

Why isn’t my Address field showing up in my Mailchimp account?

Currently, the WPForms Address field is incompatible with Mailchimp’s Address field, so this data can’t be directly passed. However, you can always build out your own Address Field with Single Line Text Fields and Dropdowns to send the information to Mailchimp that way.

That’s it! You can now set up Mailchimp integration with any forms on your site.

Would you like to grow your subscriber list even further? Check out our tutorial on leveraging lead magnets to learn how you can offer potential subscribers incentives to subscribe to your mailing lists.