Fluent Forms Integration

Fluent Forms is a popular WordPress form builder known for its performance and developer-friendly architecture. WP Smart Consent integrates with Fluent Forms to add an opt-in checkbox to any form on your site, with per-form configuration accessible directly inside the Fluent Forms editor.

Enabling the Integration#

In the WP Smart Consent dashboard, go to Form Sources and toggle Fluent Forms on. This activates the integration globally. Per-form behaviour is then configured individually inside each form’s editor.

Per-Form Settings#

WP Smart Consent adds a WP Smart Consent tab to every form inside the Fluent Forms editor. To access it, open any form in Fluent Forms → All Forms → Edit, then click the WP Smart Consent tab in the top navigation of the form settings panel. Settings are saved via AJAX so there is no full page reload.

Form Type#

Contact form — WP Smart Consent injects a consent checkbox above the submit button. The checkbox is rendered using Fluent Forms’ own custom checkbox markup and class conventions so it inherits the form’s existing styling. 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. Use this for dedicated newsletter signup forms.

Collect Fields#

Map the form’s fields to standard WPSC data fields. The dropdowns are populated automatically from your form’s registered fields using Fluent Forms’ internal field attribute names.

Email — required. Select the field that contains the submitter’s email address.

First name, Last name, Phone, Company, Country — all optional. Map whichever fields you want forwarded alongside the email.

Fluent Forms field names in the dropdown correspond to the field’s name attribute as set in the form builder (for example first_name, phone_number, your_email). Subfield values like a Name field split into first and last are each listed separately.

Extra Fields#

Below the standard field selectors, the Extra fields section lets you map any additional Fluent Forms field to a custom CRM key. Add a row, select the form field on the left, and enter the CRM key on the right.

The CRM key is the identifier your destination platform uses for that field — for example CITY in Mailchimp, city in FluentCRM, or city as a HubSpot property. That key is sent alongside the standard contact data on every opt-in.

Submission Hook#

WP Smart Consent listens on the fluentform/submission_inserted action, which fires after Fluent Forms has validated and stored the submission in the database. Field values are read from Fluent Forms’ internal submission response object and matched by the field attribute names configured in the per-form settings.

Because Fluent Forms stores submissions before firing the hook, consent is only captured on genuinely successful submissions — validation failures and spam blocks do not trigger it.

Troubleshooting#

Checkbox not appearing — confirm the form is enabled in the WP Smart Consent tab inside the form editor. Also confirm Fluent Forms is not using a custom rendering approach that bypasses the standard submit button hook.

WP Smart Consent tab not visible — if the tab does not appear in the Fluent Forms editor, confirm the Fluent Forms integration is toggled on in the WP Smart Consent dashboard and that the page has been refreshed after saving.

Settings not saving — the AJAX save requires the user to be logged in with the correct permissions. If Save Settings returns no confirmation, check the browser console for a failed AJAX call and confirm your user role has the manage_options capability.

Wrong field values forwarded — Fluent Forms field names use the attribute name, not the field label. If a field was renamed or re-keyed in the builder after mapping, re-open the WP Smart Consent tab and re-select the correct field from the dropdown.