Field mapping tells ChimpMatic which Contact Form 7 field feeds which subscriber field at your email provider. You map the fields once in the form’s Chimpmatic tab. After that, every submission arrives with the right data in the right place, so names land in name fields and phone numbers in phone fields.
How field mapping works
- First, edit your form and open the Chimpmatic tab.
- Next, connect your provider and select the destination audience, list or group.
- Then, for each mapping row, pick a Contact Form 7 field by its form tag, such as
your-name, and the provider field it should fill. - Finally, save the form, submit a test entry and check the subscriber record at the provider.
The email field is always required, because every provider uses it to identify the subscriber. ChimpMatic Lite maps the email plus up to four more fields per form, and ChimpMatic Pro expands the mapping for bigger forms.
Field mapping names at each provider
- Mailchimp uses merge fields, such as FNAME, LNAME and PHONE, plus any custom merge fields. Setup guide
- Brevo uses contact attributes, such as FIRSTNAME, LASTNAME and SMS, plus your own attributes. Setup guide
- MailerLite uses subscriber fields, such as name, last name, company and phone, plus custom fields. Setup guide
- Klaviyo uses profile properties, such as first name, last name, organization and phone number. Setup guide
- Campaign Monitor uses the subscriber name plus the custom fields of each list. Setup guide
- GetResponse uses the contact name plus custom fields that every list in the account shares. Setup guide
- EmailOctopus uses the fields of each list, such as first name and last name. Setup guide
- Moosend uses the subscriber name plus the custom fields of each email list. Setup guide
Create any custom field at the provider first. Then it appears as a mapping target in the Chimpmatic tab.
Field mapping tips that save debugging time
- One field, one meaning. A single “full name” field mapped to a first-name field puts full names in your greetings. So use separate first and last name fields when your emails greet people by name.
- Match formats. Providers often check phone and date formats, so make sure your form collects what the field expects.
- Map only what you use. ChimpMatic sends every mapped field on each submission. Therefore, keep the data as small as your marketing needs, and see what goes where.
- Test with real values. Submit the form yourself and read the subscriber record, because that one check catches nearly every mistake.
FAQ
Why is a mapped field arriving empty?
Usually the mapping points at a form field that was renamed or removed. In that case, reopen the Chimpmatic tab, select the current field, save and test again.
Can I map checkboxes or dropdowns?
Yes. ChimpMatic sends the selected value as the field’s content. For multi-select fields, however, make sure the provider field accepts more than one value.
I need more than four extra fields.
That is the Lite limit per form. ChimpMatic Pro expands field mapping and also adds advanced consent controls and subscriber tools.
Back to the help center or all integrations. Consent options are in the double opt-in guide.