Posted on

Mailchimp Required Email: Map the Email Field in Contact Form 7

The Mailchimp required email field is the single most important field in your Contact Form 7 integration. Without it, Chimpmatic cannot send any data to Mailchimp — no subscriber gets created, no merge fields get populated, and no tags get applied. In other words, every Mailchimp subscription starts with the email address.

Additionally, this guide explains why the email field is required, how to add it to your form, how to map it in Chimpmatic, and how to fix the most common issues when the email-tag dropdown is empty or the subscription silently fails.

Why Is the Mailchimp Required Email Field Mandatory?

Mailchimp uses the email address as the unique identifier for every subscriber. Specifically, it is the primary key — no two subscribers in the same audience can share the same email address. As a result, Mailchimp rejects any API request that does not include a valid email address.

Furthermore, the email field is the only field that Mailchimp truly requires. All other fields — first name, last name, birthday, phone number — are optional. Consequently, a form with nothing but an email field is technically enough to create a subscriber. However, most forms also collect at least a name for personalization.

Step 1: Add an Email Field to Your Form

In your Contact Form 7 form editor, add an email field using the [email] tag. Most importantly, the field must use the email type — not text. The asterisk makes the field required so visitors cannot submit the form without entering an email address.

For example, you can copy and paste this snippet into your form: [email* your-email]

You can see this tag in context here. This is the Form tab inside Contact Form 7:

Form

In short, the tag name your-email becomes the mail-tag that Chimpmatic uses to identify the subscriber’s email address. You can name it anything — your-email, subscriber-email, email — as long as the tag type is email and not text.

Step 2: Map the Email in Chimpmatic

After adding the email field to your form, open the Chimpmatic tab in the CF7 form editor. The Subscriber Email: *|EMAIL|* Required dropdown shows all available email-type mail-tags from your form.

ChimpMatic Lite API Key

Find your Mailchimp API here

Hit the Connect button to load your lists Learn More
Only [email-tags] will be displayed here as options:

MUST be an email tag Learn More

This may be sent as Name Learn More
If you need to add more fields, click on "Advanced Settings" and activate "Custom Fields":

Select your email mail-tag from this dropdown. Only tags with the email type appear here — text fields, textareas, and other tag types are intentionally excluded. As a result, Chimpmatic guarantees that the value it sends to Mailchimp is always a properly formatted email address.

After selecting the tag, save your form. Chimpmatic now knows which form field contains the subscriber’s email address and maps it to the *|EMAIL|* merge tag in your Mailchimp audience automatically.

What Happens If the Email Tag Is Missing?

If the Subscriber Email dropdown is empty or set to the default placeholder, Chimpmatic cannot identify the email address. Consequently, it skips the Mailchimp API call entirely.

However, the form itself still works normally. Specifically, Contact Form 7 sends the email notification to you (configured in the Mail tab), and the visitor sees the success message. In other words, everything appears to work — but nothing reaches Mailchimp.

This is the most common reason for submissions not appearing in your Mailchimp audience. The form works, the email notification arrives, but the subscriber list stays empty. If this is happening to you, the first thing to check is the Subscriber Email dropdown in the Chimpmatic tab.

Common Email Field Issues

If the Mailchimp required email field is not working as expected, check the following:

  • Wrong tag type. The field must use [email* your-email] — not [text* your-email]. Text-type tags do not appear in the email dropdown because they do not validate the input as an email address.
  • Empty dropdown. If the Subscriber Email dropdown shows no options, your form does not contain an email-type field. Go back to the Form tab and add one using the [email] tag.
  • Tag name mismatch. If you renamed your email tag in the Form tab, you must re-select it in the Chimpmatic tab. The old tag name is no longer valid.
  • Multiple email fields. If your form has more than one email field, Chimpmatic shows all of them in the dropdown. Make sure you select the correct one — the field where visitors enter their actual subscription email address.
  • Form still not sending to Mailchimp. If the email tag is correctly mapped but subscribers still are not appearing, the issue is likely elsewhere. See Contact Form 7 Not Sending to Mailchimp for the most common fixes.

Next Steps