Plugins Plugin hub Backup SEO Caching Security Forms WooCommerce Images Best backup plugins
Hosting Hosting directory Shared Managed Cloud India
Themes & builders Compare Rank Math vs Yoast
Tools All tools Hosting finder Plugin stack builder Cost calculator Salt generator Theme detector Who is hosting this? Speed test Headline analyzer robots.txt generator Redirect generator Uptime calculator Blog name generator
Best lists Best backup plugins Deals
Guides All guides Speed up WordPress Choose hosting Back up WordPress
How we test

Plugin how-tos · Guide

How to Connect WPForms to Mailchimp

Short answer

To connect WPForms to Mailchimp, install the Mailchimp addon, add your Mailchimp API key under WPForms Settings, then open a form and add a Mailchimp connection under Marketing. Choose an audience, pick Subscribe as the action, map the email field, save the form and send a test signup to confirm it works.

Key takeaways

  • The Mailchimp addon needs a WPForms Plus license or higher, as of November 2026.
  • You connect the account once with a Mailchimp API key, then link each form to an audience.
  • Five actions are available: Subscribe, Unsubscribe, Archive, Permanently Delete and Record Event.
  • Double opt-in sends a confirmation email before a new contact joins your audience.
  • A test signup with your own email is the fastest way to confirm the link works.

What do you need before you connect WPForms to Mailchimp?

You need a WordPress site with WPForms installed, a WPForms Plus license or higher, a Mailchimp account, and a Mailchimp audience already created.

An audience is the list in Mailchimp that holds your contacts. WPForms cannot create an audience for you, so set one up in Mailchimp first.

You also need an email field on your form. Mailchimp needs at least one email address per contact, and the WPForms Mailchimp addon asks you to pick the field that holds it.

If you are still weighing email tools, read the guide to Mailchimp vs newsletter plugins before you commit to a setup.

Which WPForms plan do you need for Mailchimp?

You need WPForms Plus or higher, because the Mailchimp addon is not in WPForms Lite or Basic.

The WPForms Mailchimp addon docs list a Plus license or higher as a requirement for the Mailchimp addon, and say to install the latest version of WPForms first. The free Lite version is a form builder only for this job.

WPForms pricing lists Plus at $99.50 per year as an introductory price, normally $199 per year, for use on 3 sites, as of November 2026. That plan includes Mailchimp and other marketing integrations.

WPForms planMailchimp addonSites
Lite (free)NoUnlimited installs
BasicNo1
PlusYes3
Pro and EliteYes5 and unlimited

The table above follows the WPForms pricing page and the Mailchimp addon docs, checked in November 2026. Prices change, so check the pricing page before you pay.

For a wider look at what free and paid plugins include, see free vs premium WordPress plugins.

How do you install the Mailchimp addon in WPForms?

Install the addon from WPForms Addons in your WordPress dashboard after you activate WPForms and verify your license.

Follow these steps:

  1. Open your WordPress dashboard and go to WPForms » Addons.
  2. Find the Mailchimp addon in the list.
  3. Click Install Addon and wait for it to finish.
  4. Check that its status changes to Activated.

WPForms docs say to install and activate WPForms first, then verify your license, before you install the addon. The addon will not appear as an option if your license does not cover it.

If the addon is missing from the list, check your license level first. A Lite or Basic license does not include it, and that is the most common cause.

How do you create a Mailchimp API key?

Create a new API key in your Mailchimp account and copy it at once, because Mailchimp will not show it again after you finish.

An API key is a long secret code that lets WPForms talk to your Mailchimp account. Mailchimp developer docs on API keys say an API key grants full access to your account, so treat it like a password.

Follow these steps in Mailchimp:

  1. Log in to Mailchimp and open your profile menu in the top right corner.
  2. Click Account & billing, then go to Extras » API keys.
  3. Click Create A Key.
  4. Type a clear name, such as WPForms, in the API Key Name field.
  5. Click Generate Key, then click Copy To Clipboard.
  6. Paste the key into a safe place right away.

WPForms docs warn that you cannot access an existing API key later, so you must create a new one for WPForms. Mailchimp developer docs, updated 14 September 2026, give the same warning: copy the key at once and store it in a safe place.

Keep the key out of posts, screenshots and shared files. Anyone with the key can act on your Mailchimp account.

How do you connect WPForms to Mailchimp in Settings?

Paste your API key into WPForms Settings, add an account nickname, and click Connect to Mailchimp until you see Connected.

Follow these steps in WordPress:

  1. Go to WPForms » Settings and click the Integrations tab.
  2. Click Mailchimp to expand that section.
  3. Click + Add New Account.
  4. Paste your Mailchimp API key into the API Key field.
  5. Type a nickname in the Account Nickname field.
  6. Click Connect to Mailchimp.

The nickname is only for you. It helps you tell accounts apart if you connect more than one, and your visitors never see it.

When the link works, WPForms shows a green box that says Connected next to the Mailchimp section. If you do not see it, check the key for extra spaces and try again.

You can connect more than one Mailchimp account. WPForms docs say you can add unlimited accounts, but each one needs its own API key. That helps if different forms feed different accounts.

Open the form, go to Marketing » Mailchimp, add a new connection, pick an account and an audience, then choose Subscribe as the action.

Follow these steps in the form builder:

  1. Create a new form or edit an existing one.
  2. Go to Marketing » Mailchimp in the form builder.
  3. Click Add New Connection and type a nickname for this connection.
  4. Pick your Mailchimp account from the Select Account dropdown.
  5. Pick an audience from the audience dropdown.
  6. Pick an action from the Action to Perform dropdown.
  7. Save the form.

The connection nickname is only for you. It helps when one form sends people to more than one audience, and visitors never see it.

WPForms docs list 5 actions for a form connection. The table below shows what each one does.

ActionWhat it does
SubscribeAdds the person as a new contact in your audience.
UnsubscribeRemoves an existing contact from your audience.
ArchiveArchives an existing contact in your audience.
Permanently DeleteDeletes an existing contact from your audience.
Record EventRecords an event for a contact after the form is sent.

Most signup forms use Subscribe. Use the other actions only when the form has a clear job, such as an unsubscribe form.

If you are comparing form tools first, the Contact Form 7 vs WPForms guide explains how the two builders differ.

How do you map form fields and add tags or groups?

Map each form field to a Mailchimp field, then add tags or groups so you can sort new contacts later.

After you pick Subscribe, WPForms asks for the subscriber email. Pick the form field where visitors type their email address. That field is required, and the form cannot send contacts to Mailchimp without it.

Mailchimp offers 6 default fields for mapping: Email Address, Address, Birthday, First Name, Last Name and Phone Number. Pick a Mailchimp field from the Custom Field Name dropdown, then pick the matching form field from the Form Field Value dropdown.

You can add more mapped fields with the + icon. Map only fields you need, because each extra field is one more place where a wrong match can send bad data.

Tags help you sort contacts. WPForms docs list 3 tag settings: Tags to Add, New Tags to Add and Tags to Remove. A tag is a label on a contact, such as “webinar” or “lead magnet”.

Groups work in a similar way. If your audience already has groups set up in Mailchimp, they appear in the Select Group(s) dropdown, and you can add new contacts to a group when they submit the form.

Two Subscribe options deserve a close look:

  • Enable double opt-in: Mailchimp sends a confirmation email, and the person joins only after they click the link in it.
  • Update the profile if this contact is already in an audience: Mailchimp updates the contact instead of failing when the email is already on the list.

Mailchimp help pages on opt-in explain the difference: single opt-in adds contacts at once, while double opt-in asks them to click a link in a confirmation email first. Double opt-in slows list growth a little, but it keeps bad addresses off your list.

You can also turn on conditional logic for the Mailchimp connection. For example, you can run the connection only when a visitor ticks a signup checkbox, so only people who ask to join are added.

How do you check that the connection works?

Send a test signup with your own email address, then look for that contact in Mailchimp.

Follow these steps:

  1. Put the form on a page or open its preview.
  2. Fill it in with your own email address and a name you will spot.
  3. Submit the form.
  4. Open Mailchimp and open the audience you linked.
  5. Search for your email address in the audience contacts.

If double opt-in is on, check your inbox first and click the confirmation link. Mailchimp docs say the contact joins only after that click, so a missing contact may mean the email is still waiting.

Also check the mapped fields. Open the new contact in Mailchimp and confirm the first name, last name and any other mapped fields match what you typed.

If the contact is missing, check 3 things in order: the form saved after you added the connection, the right audience is picked, and the email field is mapped. Then send one more test.

Mailchimp free plan limits matter here too. WPForms notes that Mailchimp's free plan covers 250 contacts and 500 email sends per month, as of February 2026. A full audience can block new signups, so check your plan before you blame the form.

For running costs across email tools, see how much email marketing costs for a WordPress site.

What mistakes should you avoid?

The most common mistakes are using the wrong license, reusing an old API key, picking the wrong audience, and skipping the test signup.

Watch for these:

  • Wrong license: Lite and Basic do not include the Mailchimp addon. Upgrade to Plus or higher before you start.
  • Old API key: Mailchimp does not show old keys again. Create a fresh key for WPForms instead of pasting a key you cannot read.
  • Wrong audience: One form can feed only the audience you pick. Check the audience name before you save.
  • Unmapped email field: The Subscriber Email field is required. Pick the right email field on every connection.
  • Address field mismatch: WPForms docs say the WPForms Address field does not match the Mailchimp Address field, so that data cannot pass across as one field.
  • GDPR settings clash: Mailchimp GDPR settings can mark new contacts as opted out. WPForms docs note that Mailchimp cannot see the GDPR choice made in your form.
  • No test: A form can look fine and still fail to add contacts. Send a test signup before you share the page.

Before you change plugin settings, back up your WordPress site so you can restore it if a setting breaks a page.

Frequently asked questions

Can I connect WPForms Lite to Mailchimp for free?

No. The Mailchimp addon needs a WPForms Plus license or higher, as of November 2026. WPForms Lite does not include it, and Basic does not either. You need Plus, Pro or Elite to install the addon and link a form to a Mailchimp audience.

Do I need a separate API key for each form?

No. One API key connects one Mailchimp account to WPForms, and you can link many forms to that account. You only need another key if you connect a second Mailchimp account. Each form then gets its own connection with its own audience and settings.

Why is my test signup not showing in Mailchimp?

Check double opt-in first, since the contact appears only after you click the confirmation email. Then check that the form was saved, the right audience was picked, and the email field was mapped. Also check that your Mailchimp audience is not full for your plan.

Should I turn on double opt-in in WPForms?

Yes, in most cases. Double opt-in sends a confirmation email and adds the contact only after they click the link, which keeps fake and mistyped addresses off your list. Use single opt-in only when fast list growth matters more than list quality.

Can one form add contacts to more than one Mailchimp audience?

Yes, by adding more than one Mailchimp connection to the same form. Each connection picks its own account, audience, action and field mapping. Use conditional logic if each connection should run only for certain answers, such as a checkbox choice.

What happens if someone submits the form twice with the same email?

WPForms can show a message that the email is already subscribed. If you turn on the option to update the profile for existing contacts, Mailchimp updates that contact instead. Without that option, the second signup does not create a duplicate contact.

Sources

  1. Mailchimp Addon WPForms
  2. Generate your API key Mailchimp Developer Documentation
  3. Single Opt-in vs. Double Opt-in Mailchimp
  4. WPForms Pricing and Plans WPForms
  5. WPForms – AI Form Builder for WordPress WordPress.org
  6. Detailed Plugin Guidelines WordPress Developer Resources

Is your product missing, or something out of date?

Tell us what to add or correct. We read every note and reply when we need a source. A message does not buy a ranking.

About the editors

WPLegible editors

Researched from the primary sources listed above and checked against our editorial rules. About the site · How we test