Connect Joomla contact forms. Send every lead to Mailchimp.

How the Joomla Mailchimp integration works

The Joomla Mailchimp integration connects Joomla’s core contact form to a Mailchimp audience with Contact Form Integration for Mailchimp. Choose your audience, match its available fields to the contact form, and configure consent before activating the connection.

What you need

Have a working contact form from Joomla’s core Contacts component, administrator access to install the package, and your Mailchimp API key. Use the package for Mailchimp. Each provider has its own component, and this connection uses one primary audience. Prepare any custom Contact Mail fields you want visitors to fill in before mapping them.

Install and open the extension

Get the package through the Contact Form Integration for Mailchimp directory listing. In Joomla administration, open System, Install, Extensions and upload the ZIP. Then open Components, Contact Form Integration for Mailchimp. The component name identifies the provider whose connection you are editing.

Connect your API key

Enter the key in API key, then choose Verify and stage connection. After verification, select your Mailchimp audience and choose Refresh destination fields. Verification prepares a draft; review that draft before choosing Save and activate. If you reconnect an existing connection, its active configuration stays in place until activation.

Map the fields shown for your audience

Email, required uses the native contact email automatically. The Joomla source list contains contact_name, contact_email, contact_subject, and contact_message. Published Contact Mail custom fields also appear when Public can edit their values.

The remaining Mailchimp target fields load from the selected connection’s catalogue. Read each displayed field label, type, and required marker, then select its matching Joomla source. Complete every required mapping. Leave optional fields on Do not map when you do not need to send them. List fields require a source with declared choices.

The selected destination is a Mailchimp audience. Review the fields returned for that audience before activating. A required audience field needs a mapping even when the Joomla contact form already collects an email.

Choose consent and subscription settings

Under Consent and subscription, choose a Consent checkbox field and its Affirmative values from the chosen field if only opted-in submissions should be sent. With no consent field, every valid submission is sent. If the checkbox is missing, use Manage contact fields to create a Contact Mail checkbox and allow Public to edit its value.

Review Subscriber status, Double opt-in, and Existing subscriber. Additional choices depend on the capabilities returned for this connection; use the options actually shown. Then choose Save and activate.

Test the saved connection

Submit the public contact form with a test contact you control. Check the selected Mailchimp audience and compare the mapped values. If you configured consent, repeat with the box unticked and confirm that submission does not add a subscriber. Check the provider result as well as the form’s response.

When the connection will not save

“Connection was not saved. Review the account, destination, mapping and consent settings.” means the draft did not activate. Recheck the key and selected audience, refresh its fields, and check the required mappings and the consent checkbox values. If another edit changed the connection, reload settings before trying again.

For the shared installation walkthrough, read the Joomla setup guide. The Mailchimp integration hub covers other available form connections.

When a test message reaches Mailchimp with the right fields and consent, the Joomla Mailchimp integration is ready for real visitors.