Adding people who fill in your contact form directly to a mailing list saves time and improves follow‑up. This tutorial explains how to link the popular Contact Form 7 plugin to Mailchimp using ChimpFuse, our lightweight integration add‑on. If you’re looking for a broader overview of using Contact Form 7 for email marketing, read our full integration guide first. You’ll learn how to install everything, generate and enter your API key, map fields and tags, add a GDPR‑friendly opt‑in checkbox and test the connection. At the end you’ll find troubleshooting tips and common issues.
Prerequisites
Before starting the integration, make sure you have the following:
-
-
A working WordPress installation (version 6.x or later) with administrator access.
-
The Contact Form 7 plugin installed and activated. If you’re unsure how to install a plugin, follow WordPress’s plugin installation instructions: upload the plugin folder to
/wp‑content/plugins/, then activate it on the Plugins screen. -
A Mailchimp account with at least one audience (list) set up.
-
ChimpFuse (v1) plugin files (zip). This add‑on adds a “Mailchimp Integration” tab to each Contact Form 7 form and handles API calls and tagging. Download the latest version from our site or GitHub.
-
// Install and activate ChimpFuse
-
Upload and activate ChimpFuse. From the WordPress Dashboard go to Plugins → Add New → Upload Plugin. Choose the
chimfuse.zipfile, click Install Now and then Activate. When activated, ChimpFuse adds a new Mailchimp menu item under Contact. -
Configure Mailchimp settings. Go to Settings → ChimpFuse. Paste your Mailchimp API key, click Save & Validate, and select your default audience. You can also choose your default Subscribe Mode (Pending for double opt-in or Subscribed for single opt-in).
-
Update Contact Form 7. Make sure Contact Form 7 is up to date. WordPress’s plugin directory notes that the latest version remains compatible with current WordPress releases and is widely used.
-
Enable ChimpFuse for your form. Navigate to Contact → Contact Forms and open the form you want to connect. You’ll notice a new tab labelled Mailchimp Integration. Tick Enable Mailchimp for this form to activate the integration.
// Generate your Mailchimp API key
To communicate with your Mailchimp account, ChimpFuse needs a valid API key.
Log in to Mailchimp and open your account profile.
Navigate to Account → Extras → API keys. Click Create a Key if you don’t have one. Give the key a descriptive label and copy it to your clipboard.
Return to your WordPress dashboard and go to Contact → Mailchimp → Settings. Paste the API key into the API key field and save. ChimpFuse will validate the key by fetching your available audiences.
// Map form fields to Mailchimp merge fields
With ChimpFuse enabled and the API key saved, you can connect your form fields to Mailchimp merge fields:
-
Open your chosen Contact Form 7 form and switch to the Mailchimp Integration tab.
-
From the Audience dropdown, select the Mailchimp audience (list) you want new subscribers added to. ChimpFuse lets you pick a different audience per form.
-
Choose the Email field (required) – this is the form field that contains the subscriber’s email address. For a basic form, this will be the default your-email field.
-
Under Merge fields, use the Add mapping button to map Mailchimp tags (e.g. FNAME, LNAME) to your form fields (e.g. your-name, your-lastname). The left column lists Mailchimp merge tags and the right column lists your CF7 fields. For example:
|
Mailchimp tag |
CF7 field |
|---|---|
|
FNAME |
your-name |
|
|
your-email |
|
LNAME |
your-lastname (if present) |
-
Static tags. Optionally enter a comma‑separated list of static tags (e.g. Website Signup, Newsletter) that will be applied to every subscriber who uses this form. This is useful for segmenting your audience for future campaigns.
-
Tags from fields. You can also assign tags dynamically based on field values. Select one or more CF7 fields from the list – ChimpFuse will treat each submitted value as a tag. For example, if you have a drop‑down of interests, the selected option becomes a Mailchimp tag.
-
Subscribe mode. Choose Pending to send a double opt‑in confirmation email. Pending subscribers must confirm their subscription before they appear in your list. Choose Subscribe to add them immediately (single opt‑in). Multiple Mailchimp integrations support both single and double opt‑in, so pick the option appropriate for your country’s anti‑spam laws.
-
GDPR consent checkbox. If you add a consent field to your form (see next section), select it here so ChimpFuse will only subscribe users who opt in.
// Add a GDPR‑friendly opt‑in checkbox
Mailchimp recommends using a clear opt‑in whenever you collect personal data. Contact Form 7 makes this easy:
-
Edit your form on the Form tab and insert an acceptance checkbox. For example:
[acceptance* gdpr-consent] I consent to receive marketing emails and agree to the privacy policy.[/acceptance]
-
Switch back to the Mailchimp Integration tab and select
gdpr-consentas the GDPR consent checkbox. ChimpFuse will only subscribe a user when this box is ticked.
If you don’t require consent, leave the GDPR consent checkbox setting blank. In that case all form submissions will be passed to Mailchimp automatically.
// Test your form submission
Testing ensures your integration is working correctly and that tags and merge fields appear in Mailchimp as expected.
-
Submit the form on your site with test data. Use a real email address so you can verify the confirmation email if you selected the Pending subscribe mode.
-
Check Mailchimp for the new subscriber. In your Mailchimp dashboard, go to Audience → All Contacts and filter by the tags or the date added. Confirm that the subscriber appears and that the merge fields (first name, last name, etc.) and tags are assigned correctly. When using pending mode, Mailchimp will initially list the subscriber as “pending” until they confirm.
-
Review the confirmation email (if using double opt‑in). Make sure the wording matches your brand and that the link works. You can customise the opt‑in email inside Mailchimp under Signup forms → Form builder.
If you don’t see the subscriber, double‑check that your API key is correct, the list is selected and the form fields are mapped properly.
// Troubleshooting and common issues
Even with a straightforward integration, you might encounter problems. Here are some common issues and fixes:
No subscribers appear in Mailchimp
Possible Cause
Incorrect or expired API key; wrong audience selected
Solution
Verify your API key on the ChimpFuse settings page and ensure you’re choosing the correct audience. Mailchimp’s API keys page lets you create multiple keys; use the active one.
Merge fields are blank
Possible Cause
Fields not mapped or names don’t match
Solution
Check the Merge fields table in the Mailchimp Integration tab. The left column must contain Mailchimp merge tags (e.g. FNAME, EMAIL) and the right column must reference the exact names of your CF7 fields.
Tags aren’t added
Possible Cause
Static tags field empty or mis‑typed
Solution
Make sure you separate tags with commas and avoid extra spaces. Tags from fields only work when the field exists in your form and contains text.
GDPR checkbox not required
Possible Cause
Acceptance field not marked as required
Solution
Use the * in the acceptance shortcode to enforce consent ([acceptance* gdpr-consent]). Without the asterisk, users could submit without checking the box.
Duplicate or unwanted subscribers
Possible Cause
Submitting the form multiple times or using single opt‑in
Solution
To avoid duplicates, consider using double opt‑in (Pending mode) so users must confirm before being added. This also helps with compliance.