Forminator Integration

4 min readUpdated June 25, 2026

Forminator is a free WordPress form builder from WPMU DEV. WP Smart Consent integrates with Forminator to add an opt-in checkbox to any Forminator form on your site, with per-form configuration accessible from a dedicated settings page under the Forminator admin menu.

Enabling the Integration#

In the WP Smart Consent dashboard, go to Form Sources and toggle Forminator on. Per-form behavior is then configured individually from the Forminator settings page.

A screenshot of the Forminator plugin settings shows the "General" tab active. The "Enable Forminator" toggle is on, with instructions below. At the bottom, there is a highlighted green "Save Forminator" button. The top right status shows "Inactive.

Per-Form Settings#

WP Smart Consent adds a integrations under the Forminator admin menu. Go to Forminator → integrations to see WP Smart Consent listed.

WP Smart Consent appears natively in Forminator → Integrations. Clicking Connect on a form opens a two-step wizard — Step 1 covers field mapping, Step 2 lets you override the global CRM list and tag settings on a per-form basis without affecting other forms.

Each form has two options:

Form type — choose how the form handles consent:

Contact form — a consent checkbox is injected above the submit button. The user must tick it to opt in. Leave it unticked and the submission is logged but not sent to your CRMs.
Newsletter form — no checkbox is shown. Every submission is treated as an opt-in automatically.

Field mapping — map your form’s fields to standard WPSC data fields (Email, First Name, Last Name, Phone, Company, Country). Email is required for any CRM sync to fire.

A web dashboard shows the Integrations tab. "WP Smart Consent" is listed as an active app under Applications. The sidebar on the right displays options including Form Fields, Appearance, Behavior, PDF, Email Notifications, Integrations (highlighted), and Settings.

Form Type#

Contact form — WP Smart Consent injects a consent checkbox above the submit button via the forminator_before_field_render hook. The hook fires before each field’s markup is rendered, and when a submit field is detected, the checkbox is echoed immediately before it. Only submissions where the visitor ticked the checkbox are forwarded to your CRM destinations.

Newsletter form — no checkbox is injected. Every successful submission is treated as an opt-in and forwarded automatically.

Collect Fields#

Map the form’s fields to standard WPSC data fields. Forminator field names in the dropdown correspond to the internal name attribute Forminator assigns each field — for example email-1, text-1, or name-1-first-name. Name fields that are split into first and last appear as separate entries (name-1-first-name and name-1-last-name).

Email — required. First name, Last name, Phone, Company, Country — all optional.

Extra Fields#

Below the standard field selectors, the Extra fields section lets you map any additional Forminator field to a custom CRM key. Select the form field on the left and enter the CRM key on the right. That key is sent alongside the standard contact data on every opt-in.

Submission Hook#

WP Smart Consent uses Forminator’s native addon hooks system rather than a direct WordPress action. The ForminatorAddonFormHooks class (registered automatically when the addon connects to a form) implements two methods Forminator calls internally:

on_after_render_form_fields() — called during form rendering for every form the addon is connected to. Outputs the consent checkbox HTML inside Forminator’s own output buffer, so it is safe and does not interfere with Forminator’s AJAX submission flow.

custom_entry_fields() — called by Forminator after a successful entry save. Receives $submitted_data, a flat ['element_id' => 'value'] array sourced from Forminator_CForm_Front_Action::$prepared_data — the same data source used by Forminator’s own pro integrations (Mailchimp, ActiveCampaign, etc.). The consent checkbox value is read from $submitted_data['wpsc_optin']. Only validated, successful submissions reach this method.

Troubleshooting#

WP Smart Consent settings not appearing — go to Forminator → WP Smart Consent in the WordPress admin. If that submenu item is missing, confirm the Forminator integration is enabled in the WPSC dashboard and that Forminator itself is active.

Checkbox not appearing — the checkbox only renders for forms that have been configured and enabled in their WP Smart Consent settings (either via Forminator → WP Smart Consent → Configure or via the native Forminator → Integrations wizard). Open the form’s settings and confirm the form is enabled and the form type is set to Contact form. Newsletter forms intentionally show no checkbox.

Checkbox visible but not interactive — confirm you are on WP Smart Consent 1.4.3.2 or later. Earlier builds had the checkbox input stripped by WordPress’s content sanitiser, leaving only the visual label with no functional input behind it.

Wrong field values forwarded — Forminator field names are internal slugs like email-1 or text-2, not the labels shown to visitors. If fields were removed and re-added in the form builder, the numeric suffix may have changed. Re-open the form settings at Forminator → WP Smart Consent and re-map the correct fields.