Connect Joomla contact forms. Send every lead to MailerLite.

Connect Joomla contact forms to MailerLite

Connect Joomla’s built-in contact form to a MailerLite group with Contact Form Integration for MailerLite. The extension lets you choose the group, map contact fields, and send only consented submissions when you configure a checkbox.

What you need

Have a working contact form from Joomla’s core Contacts component, administrator access to install the package, and your MailerLite API key. Use the package for MailerLite. Each provider has its own component, and this connection uses one primary group. 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 MailerLite directory listing. In Joomla administration, open System, Install, Extensions and upload the ZIP. Then open Components, Contact Form Integration for MailerLite. 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 MailerLite group 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 group

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 MailerLite 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.

Choose the MailerLite group you want this connection to use. If you change the destination while preparing the draft, refresh its fields again before reviewing the mapping.

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 MailerLite group 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 group, 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 MailerLite integration hub covers other available form connections.

Frequently asked questions

Why is a checkbox option missing from the MailerLite consent choices?

The Joomla extension removes blank and negative checkbox values from the choices that can authorize delivery to MailerLite. Values such as zero, false, off, and no are excluded even if their visible labels look affirmative. Review the Contact Mail field’s stored option values as well as its labels. Select an actual positive option and test the published form with that choice.

Why does a choice-field mapping prevent the MailerLite connection from saving?

For a destination field with choices, the extension checks the values declared by the Joomla source. When MailerLite supplies an allowed-choice list, the source must share at least one permitted value. A list field also needs declared source choices. Matching visible labels is not enough if the stored values differ. Review the source options and destination choices, refresh the mapping, and save again.

Why are some MailerLite confirmation settings unavailable in Joomla?

The settings screen builds its choices from the capabilities returned for the MailerLite connection. Pending confirmation and explicit double opt-in overrides appear only when those capabilities allow them. The save operation validates the same restrictions, so submitting an unsupported value does not enable it. Refresh the connection’s fields and capabilities, then use the choices shown for that connection rather than assuming another integration’s settings apply.