Mailchimp

The Mailchimp add-on adds the people who write to you to your Mailchimp audience: with their details as merge fields, your tags, and Mailchimp’s own double opt-in.

Set it up

1. In Mailchimp, open Profile → Extras → API keys and click Create A Key.
2. Paste it in Contact Form → Settings → Integrations → Mailchimp and save. The card says Connected when Mailchimp takes it.
3. Open a form, then its Mailchimp tab, and pick the audience.

The form’s Mailchimp tab

Setting	What it does
Mailchimp audience	Where contacts go. Don’t add to Mailchimp leaves this form out.
Add them only if they tick	The checkbox where people agree to get your emails. Always for a newsletter sign-up form.
Their email address is in	The first Email field, or the one you pick.
Ask them to confirm their email first	On at first. Mailchimp emails new contacts a confirmation link, and they join once they click it.
Details to save	Pairs of a merge field (FNAME, LNAME, PHONE or your own) and the form field it comes from. Nothing added: FNAME and LNAME come from a field called name, first name or last name, PHONE from a Phone field.
Tags	Separated by commas, for segments and automations. Mail tags work too, such as [_form_title] or a select’s [plan]. website at first.

Someone already in your audience

Anyone can type anyone’s email into a form, so a contact Mailchimp already has keeps their details and their status, subscribed or not: they only get the form’s tags. Someone who unsubscribed isn’t signed up again.

A merge field your audience doesn’t have would make Mailchimp turn the whole contact away; the add-on then adds them without the details rather than not at all.

For developers

Nothing is sent while the form is in Test mode.

Hook	What it does
remaily_mailchimp_member	The contact sent: ( $member, $audience, $submission ), with email_address, status_if_new, merge_fields and tags. Return an empty array to send nothing.