Connect Joomla contact forms. Send every lead to Kit (formerly ConvertKit).

Connect Joomla contact forms to Kit

Send Joomla contact form submissions to a Kit form with Contact Form Integration for Kit. Select the form in Joomla, map the available fields, and choose whether a visitor must tick a consent checkbox before a submission is sent.

What you need

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

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 Kit 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 destination is a Kit form. Choose it before refreshing, because the field catalogue belongs to the connection you are preparing. This extension uses one global mapping and one primary destination.

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

Frequently asked questions

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

The Joomla extension removes blank and negative checkbox values from the choices that can authorize delivery to Kit. 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 Kit connection from saving?

For a destination field with choices, the extension checks the values declared by the Joomla source. When Kit 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 Kit confirmation settings unavailable in Joomla?

The settings screen builds its choices from the capabilities returned for the Kit 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.