Forminator Integration

3 min readUpdated June 20, 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#

Because Forminator registers its forms as a hidden post type with no standard WordPress list screen, WP Smart Consent adds a dedicated submenu page under the Forminator admin menu. Go to Forminator → WP Smart Consent to see all your Forminator forms listed. Click any form to open its WP Smart Consent settings, where you can set the form type and map fields.

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 listens on forminator_form_after_handle_submit, which fires after every form submission attempt — both full page and AJAX. The hook includes a $response array with a success key, and WP Smart Consent gates on that value so only validated, successful submissions trigger consent capture. Field values are read from Forminator_CForm_Front_Action::$info['field_data_array'], an indexed array of ['name' => ..., 'value' => ...] entries.

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 — confirm the form is enabled in its WP Smart Consent settings. Also confirm no other Forminator add-on or custom code is hooking forminator_before_field_render at a higher priority and suppressing the submit field detection.

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-select the correct fields.