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.

Frequently asked questions

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

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

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

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