Connect Joomla contact forms. Send every lead to Klaviyo.

Connect Joomla contact forms to Klaviyo

Use Contact Form Integration for Klaviyo to send Joomla contact form submissions to a Klaviyo list. The settings screen lets you map contact data and declare custom profile properties 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 Klaviyo API key. Use the package for Klaviyo. Each provider has its own component, and this connection uses one primary list. 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 Klaviyo directory listing. In Joomla administration, open System, Install, Extensions and upload the ZIP. Then open Components, Contact Form Integration for Klaviyo. 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 Klaviyo list 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 list

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

Open Custom profile properties to declare a property name and type, then refresh. Available types are text, number, date, boolean, list, and datetime. Use the property’s intended type when selecting its Joomla source.

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