4. Forminator

With dozens of available field types and an ever-expanding list of integrated third-party apps, there is almost no limit to the type of forms you can create with Forminator.

Regardless of the type of form you are creating, however, the fundamental process is the same:

• Build a form
• Configure the fields
• Configure form appearance and behavior
• Connect third-party apps (optional)
• Test the form
• Publish

Getting Started

From the Dashboard, click + Create within the Forms pane, or navigate via the Admin menu: Forminator Pro > Forms and click + Create .

A popup will open where you can select a form template or choose to begin from scratch by selecting Blank.

Templates

Forminator provides several templates to help streamline the form creation process. Templates are ideal for admins with little experience configuring form field behavior.

Each template includes fields commonly associated with that form type, including some specialized fields not available elsewhere in Forminator, such as a password field. These fields are pre-configured, some with complex conditional formatting, to effectively collect and manage user-submitted data.

Templates can be customized by adding or removing fields like any other form.

Forminator’s templates include:

• Blank – Use this template to create a form with no default fields.
• Contact Form – A simple form designed to collect user-submitted contact information.

• Quote Request – A form with which users can submit a detailed request for feedback or more information.
• Newsletter – A basic subscription form.
• Registration Form – A powerful form designed to facilitate the creation of user profiles. See the Registration and Login Forms section below form more information.
• Login – A specialized form equipped with features to support a custom login screen. See the Registration and Login Forms section below form more information.
• Create Post – A form that already includes the Post Data field needed so your users can submit posts from a frontend form.

A popup will appear in which you can give your form a name. Each form must have a name, but changing that name later is easy. When you’ve entered a name, click Create.

Forminator will create the form and open it in the Edit Form screen. You’ll see that your new form canvas is ready for you to start adding fields, and already has the Submit button. Click + Insert Fields to start building your form, and review the following chapters for guidance on configuring fields and other options.

Also, just a note that you can access your form settings from inside the editor by clicking on the gear icon next to the form title. To create a new form, click the plus icon.

Publishing a form

When you create or edit your form, you’ll have the option to save your progress as a Draft or Publish your form.

Once your form is published, you’ll be able to Unpublish or Update after making changes.

Registration and Login forms are two special form types, so we’ve developed a template for each with key field behaviors built-in. See the video below for a walk-through of using Forminator to create a Registration and Login Page, featuring these two special form types.

This section covers only those fields which are unique to the Registration and Login templates:

• Password field – A specially-designed field that, depending on its configuration, allows/requires users to create a password-protected account with the site.
• User Registration tab – A unique tab only available in the Registration Form template containing the options that govern user account creation.

Registration Template

Click the Create button, and when prompted, select the Registration template and click Continue.

Name the form and click Create.

Password Field

The password field is unique to this template. To customize the password field, click the gear icon to expand the drop-down menu and click Edit Field.

Click the Settings tab.

Minimum password strength

This setting controls the minimum password strength required for the registration form to be accepted.

Custom error messages

Use the fields provided to create custom error messages when users submit inadequate passwords or fail to enter a password at all.

User Registration Tab

Click the User Registration tab to see the following configuration options:

• User Meta Mapping – Map default WordPress user meta keys to specific fields in your form.
• User Account Activation – Options governing how accounts are created and how users are notified.
• Additional Settings – There options determine login page behavior following account creation.

User Meta Mapping

The WordPress usermeta table was created to allow sites to expand the stored data associated with its registered users. Mapping meta keys to form fields allows admins to customize what user data is collected and how the data is stored by WordPress.

Default Meta Keys

Forminator makes the following default user meta keys available:

• Username
• Email
• First Name
• Last Name
• Website
• Password
• Role

Click any field to access a drop-down menu showing the fields from the current form and their respective meta keys. Selecting a field will cause Forminator to create a table entry for that information. Any field with that meta key will store the data to the indicated table.

Note that the Password setting here has an option to assign an Auto Generated Password to users who sign up through your form. If you select that option, you’d want to delete the Password field from your form if you still have one in there, as it would serve no purpose and would likely confuse your users. A notice will appear to remind you of this if you select that option.

If there is no Password field in your form, or if you have already removed it, a notice will appear here to remind you to add one if you want your users to be able to set their own passwords.

User Role

You can choose to assign the same user role to all users, or conditionally assign roles based on user input in your registration form.

• Fixed Role to All – Select this option to assign the same role to all users who signup.
• Assign Role Conditionally – Choose this option if you want to assign a user role based on user input.

As an example, let’s say you have a checkbox field in your registration form with Yes/No answers to a question like this: Will you be submitting content to this site?

You could set this up to assign the Subscriber role to users who select No as their answer to that question, and assign the Contributor role to users who select Yes.

To assign another role based on a different condition, click the Add User Role button at the bottom.

Custom User Meta

To create custom user meta keys, first enable the feature by clicking the Add Custom User Meta toggle. Next, click the Add Custom User Meta field.

Site Registration (Multisite only)

If Forminator is network-active in a multisite network, you will see an additional option in the User Registration settings when editing a Registration form in the main site of the network: Site Registration.

Enable this option if you wish to allow your users to create a site in your network using your registration form.

The following form fields are required if you enable this, so you’ll want to ensure you have added input fields in your form for these first so you can map them.

• Site Name – This is to be mapped to the field your users will use to enter their site address, which will be automatically appended to your network address.
• Site Title – Map this one to the field in your form used for the site title or tagline.
• Site Role – Select the role to assign to the user on their new site in your network.

User Account Activation

By default, user accounts are activated as soon as a properly completed form is submitted. However other options are available.

• Default – Account is activated as soon as form is submitted.
• Email Activation – Requires users to respond to a link in an email to activate their account.
• Manual Approval – Suspend account activation until a site admin approves its creation.

Note that if you have enabled the option to assign an Auto Generated Password to users who sign up through your form, you’ll want to keep the Activation Email setting to Default so the needed notification emails can be sent to the user.

Additional Settings

Enable the toggle to log new users in as soon as the account is activated.

Registered users don’t need to see the registration form again, so hide the form from them by enabling that feature.

If you wish, use the message editor to display a message to registered users instead of the displaying the form.

The Appearance options control a form’s overall design, its colors, and the look of its container.

Appearance Presets

You can style the appearance of any form using the options as detailed below, or apply one of your custom Appearance Presets. To apply a preset, simply click the Apply Preset button at the top-right.

That will pop open a modal window where you’ll be prompted to select the preset you want from the dropdown. Then click Apply Preset to populate all the design elements on this screen with your preset styles.

You can use your preset style as-is in your form or further customize the style if needed for a specific form.

Note that any changes you make here will not affect the preset style itself or any other forms using that preset; they will only affect the specific form you’re working on. To edit the preset style itself, go to Settings > Appearance Presets.

Design Style

Use one of our pre-made themes as a starting point for further customization or select None to have your form inherit styles from your theme’s CSS.

If you select None, you will not be able to change colors, fonts or the form container from the Appearance tab. You will need to make customizations in your theme’s CSS files.

Colors

For colors you can use the default colors or select custom to access background and text colors for a variety of elements in your form. Simply open the element you want to change the color for and make your changes.

Fonts

Setup your desired fonts, font size and font weight, for the labels, section titles, pagination steps and all the other different elements in your form.

Form Container

Further customize the appearance of the form main container by adding padding, a border and the spacing between form fields.

Lets you choose a Compact or a wider, Comfortable separation between fields.

Custom CSS

Our Custom CSS option was built in way so you can customize your form using CSS. We added a lot of selectors for your convenience but if you need help with CSS our 24/7 Live Support will be right by your side.

The Behavior options control what happens when a user submits a form.

Submission Behavior

After Submission

Here, you can configure what should happen after a successful submission of your form.

You can set only one submission behavior if that’s all you need. For example, redirect all users to a thank-you page.

Or you can set up several different behaviors which can each be processed conditionally based on submitted form data.

For example, display a thank-you message above the form if a user had selected certain options in your form, redirect other users to different pages if they had selected different options, and/or hide the form & display a message to users who selected yet other options.

When setting up multiple submission behaviors, you’ll need to configure the conditional logic for each one. If you don’t, only the first submission behavior will be processed. You’ll see a notice appear in this section if you forget to set up your conditions:

To add a new submission behavior, click the + Add Behavior button.

To configure or edit an existing submission behavior, simply click on it to pop open a modal window with the configuration options.

After Submission – Behavior

Under the Behavior tab, you can select from the following types of behavior:

• Inline Message – Display a custom message that appears above the form after submission.
• Redirect user to a URL – Redirect the user to any URL after submission.
• Hide form – Hide the form and display a custom message after submission.

Inline Message or Hide form

If you select either Inline Message or Hide form, submitted form data can be included in the custom message by clicking the Add form data button and selecting from the list of merge tags.

For example, you could personalize the message by including the merge tag corresponding to a Name field in your form, and display something like this:

Thanks John! We’ll be in touch shortly.

See Form Data below for more information about merge tags.

Redirect user to a URL

You can redirect a user to another page on your site or on a different site altogether.

Enter the Redirect URL of the page you want users to land on after submission, and select from the available Redirection Options:

• Redirect on the same tab
• Redirect on new tab and show thank you message on form page
• Redirect on new tab and hide form on the form page

Dynamic redirects after submission

The [+] icon at the far right of the Redirect URL field enables you to use form data in your URL via merge tags. This can be very useful if you need to redirect users to different pages depending on a selected option in your form, and this can work in conjunction with the conditional logic you set up in the next step.

For example, let’s say you have a select field in a quote request form where users specify the product category they’re most interested in. You could set a different URL as the value in each option in your select field.

If you then add that selected merge tag to the Redirect URL field here, your users can be redirected to those specific product category pages on your site after they submit your form.

Dynamically redirecting like this also works just fine when pre-populating form field values. This means that you can redirect to different URLs based on user input, and pre-populate new forms at those URLs with data from the form they just submitted.

To follow along on the previous example, users who submitted the quote request form could be redirected to the page of the product category they’re most interested in, with their name & email address (or any other data from the form) already entered in a newsletter optin like “Want our best [category] deals delivered weekly to your inbox? Just click Yes!”

After Submission – Conditions

Under the Conditions tab, you can configure the specific conditions under which your submission behavior should be triggered.

You’ll first want to select whether All conditions should be met, or Any of them. Then click + Add Conditions to add one or more conditions for this submission behavior.

If you select All, then all conditions you set here must be satisfied for this behavior to trigger.

If you select Any, then any condition you set here will trigger this behavior. Be careful to not set duplicate conditions in multiple behaviors that are set to Any though. If you do, only the first behavior where the specific Any condition is met will be processed.

The conditions for form submissions work just like conditions for your form fields. Select the form Field that should be checked, what Condition should be satisfied, and what the field Value should be for the condition to be processed.

In the above example, we’ve set the condition to check whether the Value of the radio-1 field is Option 1. If it is, this condition will be processed and the submission behavior will be triggered.

Click the + Add Condition button to add as many conditions as you need for your submission behavior.

Method

Save your server resources by using AJAX for form submission. Send only one request instead of many that are needed to load the full page.

Validation

Lets you choose your validation method.

• Server only – When you click the Submit button, a request is sent to the server and validation is returned from the server via AJAX or via PHP validation on refresh. This is good if you know you have a lot of users that use outdated browsers (like IE5/IE6) or are navigating you to your form from mobile browsers that don’t support inline validation.
• On form submit – Validation happens when you click the Submit button, but the data never gets sent to the server if is it isn’t valid (this uses Javascript validation) – this should work with most browsers
• Enable inline validation – Validation happens as user types using Javascript and this might be the best option for modern browsers

Autofill

In case you need some of the fields auto-populated, you can set that up here. The autofill works on the Text, the Name, and the Email field.

You can also make the auto-populated data editable or not.

Security

This section allows you to protect your form.

• Enable honeypot protection – Having trouble with bots? This will trick and trap spam bots into revealing themselves by giving them a challenge that human users cannot see. How does this work? When the form is displayed in the browser it creates a hidden input. A hidden input must match the desired condition and if the condition doesn’t match a success message such as “Form entry saved” will be sent to the bot, but the form will not be actually submitted. Also, because the honeypot input is hidden and generated only when the form is displayed in the browser – bots will also tend to miss that and will send a request without the hidden input (which will make them fail the honeypot test).
• Enable Akismet spam protection – If you are using the Akismet plugin on your site, you can enable this option, and select to either fail any submissions that Akismet detects as spam, or simply mark them as spam. Selecting the Fail Submissions option would display a customizable message to the user, and Mark as Spam would log them in your database but they would not appear in your Submissions list.
• Enable logged in submission only – Only registered users will be able to use your form.

Lifespan

Configures the lifespan of your form. You can choose for it not to expire, to expire on a certain date or after a certain amount of submits.

Take note that once the form expires it will not be visible on the front-end (but will be still available in the back-end).

Rendering

This lets you choose how to render your form to accommodate cache plugins that may cause issues.

Use Ajax will do just that in order to avoid any cache issues that may arise because of plugins that have Page Cache ability.

Enable Use DONOTCACHEPAGE Constant to utilize the constant in cache plugins like Hummingbird to skip page cache on the pages that contain your Forminator form.

Email notifications can be configured in the form’s Email Notification tab, enabling custom emails to be sent to admins or users upon form submission, with emails routed based on form data. By default, an Admin Email notification is added when a form is created, though it can be edited or deleted as desired.

To add an email notification, click Add Email Notification.

Form Data

Form data can be included in your notification email subject and body, as well as in various other text fields, through the use of merge tags.

Merge tags can be inserted for any required or optional fields in the form in addition to the following pieces of form data:

• Form Name – Use the {form_name} merge tag
• All Form Fields – {all_fields}
• All Non Empty Fields – {all_non_empty_fields}
• Submission ID – {submission_id}
• User IP Address – {user_ip}
• Date (mm/dd/yyyy) – {date_mdy}
• Date (dd/mm/yyyy) – {date_dmy}
• Embed Post/Page ID – {embed_id}
• Embed Post/Page Title – {embed_title}
• Embed URL – {embed_url}
• HTTP User Agent – {user_agent}
• HTTP Refer URL – {refer_url}
• User ID – {user_id}
• User Display Name – {user_name}
• User Email – {user_email}
• User Login – {user_login}
• Custom Value – {custom_value}
• Query Parameter – {query} – Please ignore this tag as it serves no purpose for emails and will be removed from these options shortly.

Where supported, click any form data icon or [+] icon to select and insert available merge tags. Alternatively, you can type out the merge tag directly.

For example, the following subject line includes the merge tags {submission_id} and {form_name}, representing the ID of the form submission and the name of your form respectively:

New Form Entry #{submission_id} for {form_name}

Accordingly, an email notification sent upon form submission would read as “New Form Entry #12 for My Form”.

Similarly, let’s say you’re using Name and/or Address fields set to Multiple in your form. You could use the specific fields you need to really personalize email notifications to your users. For example, a subject line could include the user’s first name only, with a welcome to users from their country in the message body.
Welcome {name-1-first-name}!
It's always nice to see people from {address-1-country}.

You can also use standard HTML tags in the email body when editing in Text mode. However, just like when editing regular WordPress posts, some tags may be stripped out if you switch to Visual mode.

Email Tab

• Label – The label you set here only appears internally and does not show up anywhere in the email itself.
• Subject – The subject line is what appears in email clients like Gmail as the email subject, so that’s what your users see in their inbox before they open the email.
• Body – The body is where you compose the email message itself.

Recipients Tab

Default

The default behavior is to send the notification for every form submission to the same recipients. You can add as many recipients as you like, separating each address with a comma. Simply enter the recipients’ email addresses in the Recipients field and click the Add button to save.

Email Routing

Email routing enables you to send notifications to different recipients conditionally based on user input in your form. For each recipient, set up conditions just like you would do for conditional display of form fields. You can set up as many recipients as you need with different conditions for each.

The image below shows an example of a condition set to send the email to [email protected] if the the user has selected the Sales option for a field called checkbox-1 in the form.

Advanced Tab

The options under this tab enable you to customize the from name, from email and reply-to email, as well as any CC or BCC addresses you wish to send to.

You can either manually enter the needed info in each field, or click the [+] sign to the right of each one to reveal shortcuts that, when clicked, automatically insert the corresponding merge tag in the field.

Conditions Tab

In addition to conditionally routing emails to different addresses, you can even set up rules to send emails only if certain conditions are met. Again, this is set up exactly the same way as the conditional display of form fields.

The image below shows an example of a condition set to send an email only if the user has selected the I would like a reply option for a field called checkbox-2 in the form.

Using the Conditions here and the Email Routing option under the Recipients tab can be a powerful combination, enabling you to trigger emails and send them to different departments in your organization all based on user input.

Connect your third-party app accounts and send data to your favorite apps. Our integrations module makes this easy and you’ll be up and running in no time.

You can connect as many apps as you need, and as many instances of each app, to any form. You can also send your form data to different lists of the same app, or assign different groups/tags in the same list, depending on user input in your form (see Sending Data Conditionally and the full MailChimp example below).

Once you have configured the app accounts you want, they will appear in the Connected Apps section under the Integrations tab of every form. Connect any app to that specific form by clicking the [+] icon in its row.

They will then appear in the Active Apps section where you can click the gear icon if you need to adjust that app’s settings afterwards.

To see how to configure these integrations follow the links here:

• MailChimp
• Campaign Monitor
• ActiveCampaign
• Zapier
• HubSpot
• Google Sheets
• AWeber
• Slack
• Trello

Sending Data Conditionally

As noted above, you can have as many instances of each app as you want connected to a form, and you can send data conditionally to any connected app depending on user input in the form.

The conditional logic feature here works similarly to when setting up Visibility Conditions for a form field.

Once you have your app connected, click the Conditions button in that app’s row.

That will pop open a modal window where you’ll first want to select whether you want to Send data or Don’t Send data when your conditions are met. Then select whether All or Any of your conditions should be met.

Next, click the + Add Conditions button to define under which conditions you want the Send/Don’t Send action to be triggered.

You can select any available field from your form to use as a condition. For each field you want to use, you’ll set the Condition and the Value or Option it should contain for that condition to be applied.

For example, let’s say you want to send data to your connected Hubspot list only if the user selects Canada in a Country field in your form. You’d select your Country field here, set Is as the Condition, and select Canada as the option.

Click the + Add Condition button for any additional conditions you want to add. Once you’re done, click the Apply button.

Sending Data Conditionally – MailChimp Example

This walkthrough will help you configure your MailChimp integration to add contacts to different groups and/or add different tags depending on user input in your form.

If you’ve never set up MailChimp integration in Forminator, you’ll want to first review that chapter below. You can use this example as a guide for setting up a similar configuration with any other integration.

In this example, we’ll use a simple form where the user selects which of 3 age groups they belong to.

Then depending on their selection, they get added to the corresponding age group in the MailChimp audience, with a similar tag added as well.

You’ll first want to ensure that you have created a group in your MailChimp account with the 3 age groups being used in your Forminator form. In this example, we set up a radio group, but you can use any type that suits your project. You can omit this step if you only need tags as below.

You’ll then set up some tags as well in your MailChimp audience. You can of course omit this step if you only need groups as above.

Next, back in your site admin, add a radio field to your Forminator form with the desired options. You can of course use checkboxes or a select field for this if you prefer.

Now that you have the groups and/or tags set up in your MailChimp audience and the radio, checkboxes or select field added to your form, head on over to Forminator > Integrations. You’ll want to set up 3 MailChimp integrations and give each one a different name so you can recognize them later.

To get that done, click the + icon next to MailChimp in the Available Apps section.

In the modal window that pops open, add your MailChimp API Key and give your integration an easy-to-recognize name as its Identifier, and click Save.

Repeat that 2 more times so you have 3 MailChimp integrations set up, each with a unique Identifier.

Now head on over to the Integrations tab of the form where you added the Age Group radio field, and you’ll see the 3 MailChimp integrations you just set up in the Connected Apps section there.

Click the + icon next to the first one. In the modal window that pops open, select the Audience you added the groups & tags to. Then in the next steps, select the tag(s) and/or group(s) you want to add to the contact when a user submits your form.

In this example setup, we want to add the contact to the age group they select in our form, and also add the tag corresponding to that same age group, so we’d select both.

In the final step, you’ll map your form fields to your MailChimp fields as usual.

Then repeat the previous steps to connect the other 2, ensuring you select the appropriate age group and/or tag in each one. You’ll then see all 3 of your MailChimp apps now in the Active Apps section.

The final step is to set up the conditions so each one only sends data according to the age group the user selects in the form.

Click the Conditions button next to the first MailChimp active app. Then, following the directions in Sending Data Conditionally above, select the value of the radio field in your form that corresponds to the group and/or tag you want to add the contact to in your MailChimp list.

In our example, we want to add to the 15-30 age group if a user selects the 15-30 option in the form. So the condition we’d add to the 1st app is to Send if the Age Group is 15-30. Click the Apply button to save that condition.

Repeat that for each of the other 2 MailChimp apps, ensuring you select the radio option in each one that corresponds to the age group and/or tag you want to add the contact to.

You’ll then see a yellow icon appear next to each active MailChimp app. Hover your mouse over that icon to reveal a tooltip that indicates the condition(s) you set for that app.

Now when a user selects an age group in your form, they’ll be added to the selected Age Group in your MailChimp Audience, with the corresponding tag added as well.

You can use that in your MailChimp account to create segments and send different newsletters to the different age groups, or any other automation that you see fit.

Settings allows you to customize how the data for your form is stored.

Data Storage

In cases where you don’t want to store the forms data on your server, you can choose to Disable store submissions in my database.

Privacy

Submissions

Forms collect a lot of sensitive information. In the privacy section, you have the option of auto deleting form submissions once they reach a certain age.

You can set the number of days, weeks, months or years. Once a form entry reaches the date you specify, it will be deleted.

Account Erasure Requests

Here you can choose what will happen to the submission of a user you are deleting from your site (by using Tools/Erase personal data) if the submission contains an email address associated with that user.

• Retain submissions – will leave all submissions of that user intact.
• Remove submissions – will remove all submission from the user you deleted from your site.

Submission Files

Choose whether to keep or delete any files related to a submission when the submission gets deleted.

One of the most useful Forminator features in the admin is the live preview.

Not only can you see the form fields, including how your conditional rules are operating, but you can also view the changes you make to your forms appearance.

If you make changes to your form’s design style, colors, fonts, form container, etc. you can use the preview mode to see the outcome.

For example, here we see a live preview of the difference between two built-in layout styles.

Each form comes with a shortcode which you can use to embed your form anywhere on your site where shortcodes can be used: pages, posts, widgets, etc.

Any time you click the Publish button for a form in the form editor, a modal will pop open to show you the shortcode for that form.

To get the shortcode for any form after having published it, go to the Forminator Forms page. Find the form you’d like to use and select the gear icon to open the settings dropdown for the form.

Select Copy Shortcode, which will automatically add the shortcode to your clipboard so you can paste it anywhere.

You can also add a form to your post while in the WordPress editor. In the Classic editor, click the Form button next to the media uploader button.

Then select the form you want to embed in the modal that pops open.

In the Gutenberg editor, click the [+] icon to add a new block, and find the Form block.

Once the block is added, select the form you want to embed in the post.

In case you want to present your Form in a Widget, navigate to Appearance > Widgets, drag the Forminator Widget to your sidebar, choose what would you like to display and press on the Save button:

How to display a form in Hustle

If you’re using WPMU DEV’s Hustle plugin to create marketing embed modules, slide-ins and pop-ups, you can add Forminator forms to the main content area.

You’ll first want to create your Forminator form, then select the embed, slide-in or pop-up module in Hustle where you want to add the form.

In the main content area of your Hustle module, click the Form icon (same as the one in the Classic editor for any post or page).

From there, you’ll be able to choose a form, poll or quiz to add to your Hustle embed box.

Forminator makes it easy to pre-populate fields in one form with values from another form’s fields.

To do that, you’ll need to select the Redirect user to a URL option for the Submission Behavior under the Behavior tab for your first form, and enter the URL to the page containing the 2nd form whose fields you want to pre-populate.

Then, you’ll need to add query parameters to the URL.

For example, to pre-populate a field in the 2nd form with an email address, add a question mark (?) to the end of the URL to indicate a query. Then, add the query parameter key to identify the pre-populated data, followed by an equals sign (=). This key can be any string of text, but use something relevant and recognizable, such as email:

https://yourcoolsite.tld/form-2?email=

Next, click the [+] icon to select and insert available merge tags, representing the pre-populated data. For example, to insert the date from the email address field in your form, select Email Address.

See Form Data above for more information about inserted form data using merge fields.

If you need more than one parameter in your URL to populate more than one field, just add an ampersand – & – then add the next query parameter key and value. For example, here’s a URL with 2 key/value pairs that can be used in the 2nd form:

https://yourcoolsite.tld/form-2?email={email-1}&check={checkbox-1}

To use the values you have now defined in the redirect URL, go to your 2nd form and open the settings for the field you want to pre-populate.

Under the Settings tab for your field, scroll down to the Pre-populate section, and enter the query parameter key you set for the field in the 1st form. In our example above, we simply used the word email as the key, so that’s what we would enter here.

Please note that certain terms are reserved by WordPress and it is not recommended to use them as query parameters in this feature as that may cause unexpected form behavior. See the full list of reserved terms here.

Now when your users submit the 1st form, the value will be pre-populated in the field in the 2nd form.

Adds a name field to your form.

Name Labels

In the Labels tab, you have two options, single and multiple. Single will create one field for a name, while multiple will split the name into prefix, first name, middle name and last name.

Select single to change the field Label, enter Placeholder text or add a custom Description for a single Name field.

Select Multiple to open additional options so you can add Prefix, First Name, Middle Name or Last Name to your Name field.

Open a field to change the Field Label, put Placeholder text or add a custom Description for the name fields you’ve activated.

Adds an email field to your form.

Email Labels

In the Labels tab, you can change the Field Label, put Placeholder text or add a custom Description.

Email Settings

Validate Field: Each time a user enters an email address, this field will check if it has a valid format. Enabling this will let you enter your custom validation message that will appear if the email is invalid.

Adds a phone field to your form.

Phone Labels

In the Labels tab, you can change the Field Label, put Placeholder text or add a custom Description.

Phone Settings

Validate Field: Each time a user enters a phone number, this field will check if it has a valid format. You can choose a National, International format or you can limit the number of characters. Enabling this will let you enter your custom validation message that will appear if the phone number is invalid.

Adds an address field to your form.

Address Labels

In the Labels tab, you can activate the different address subfields that you want to use.

To change the Field Label, put Placeholder text or add a custom Description, open the subfield.

Adds a website field to your form.

Website Labels

In the Labels tab, you can change the Field Label, put Placeholder text, add a Default Value or add a custom Description.

Website Settings

Validate Field: Each time a user enters a website URL, this field will check if it has a valid format. Enabling this will let you enter your custom validation message that will appear if the website format is invalid.

Adds a single line text input field to your form.

Input Labels

In the Labels tab, you can change the Field Label, put Placeholder text, add a Default Value or add a custom Description.

Input Settings

Max characters: You can limit the number of characters allowed in this field.

Adds a textarea field to your form.

Textarea Labels

In the Labels tab, you can change the Field Label, put Placeholder text, add a Default Value or add a custom Description.

Textarea Settings

Enable the Rich-Text editor option if you want your textarea field to be a WYSIWYG editor. You can also set the Max characters and Default Height for the textarea field.

Adds a number field to your form.

Number Labels

In the Labels tab, you can change the Field Label, put Placeholder text, add a Default Value or add a custom Description.

Number Settings

The Settings tab allows you to adjust various aspects of the Number field functionality, including value limits and formatting.

To force users to fill out the Number field, select Required. Otherwise, the field will be optional. 

To restrict the minimum and/or maximum values that a user can choose, enter a minimum and/or maximum value in the respective fields, and optionally set custom error messages for values beyond these bounds. Leave the fields blank to allow the user to choose any number, including a negative value.

Choose your preferred decimal separator from the Separators drop-down menu. To round the field’s value automatically, choose the maximum number of decimal places from the Round To drop-down menu.

Lastly, to pre-populate the field dynamically using a query parameter passed in your form URL, enter a query parameter key in the Query parameter field.

Number Calculations

You can choose whether or not to allow this field to be used to create formulae within Calculations fields in your form. Select Enable to allow the field to be used in calculations.

If enabled, the value used in calculations would be the value input by the user.

Adds a radio button field to your form.

Radio Labels

Basic Options

Under the Labels tab, you can customize the Field Label and add an optional Description.

Then, for each radio button option, you will need to input the option Label (that your users will see in the form) and its Value (this is what is stored in the database). Note that you can format the options label texts using the HTML text formatting tags. For now, the <strong> and <em> are the only supported tags.

To do that, click the caret icon at the far right of any radio option to toggle it open and reveal the additional fields and settings for that option. Or click the Expand All / Collapse All toggle to reveal all settings for all options.

To make any option pre-selected in your form, check the Selected box. Your site visitors will of course be able to change that selection when they fill out the form.

Click on the Add Option area to manually add radio button options. Click the red trash icon next to any option you would like to delete.

Using Images

If you would like to use images in your radio options, check the Enable Images box. That will add an Upload Image button to each radio option.

You can customize the layout and label visibility for image options under the Settings tab below.

Your image options could look like this example in your frontend form with radio buttons and labels showing:

You can adjust the colors for the selected state in your form’s Appearance settings.

Bulk Edit

Enable the Bulk Edit feature if you have a large number of options you want to add to your radio field. There are 3 ways you can bulk add options to your radio field:

• Manually
• Via CSV file
• Predefined options

Any existing options you have already manually created will automatically populate in the Bulk Edit area. If you don’t need those, simply delete them from the Bulk Edit area.

Manually enter bulk options

If you wish to manually enter or paste your list of options in the Bulk Edit area, they must be entered one per line with each term separated by a semicolon, in this order (note that the last term on each line should not be followed by a semicolon):

• Option label;
• Option value;
• Selected; – only one option can be set as selected and should be designated with the number 1
• Image URL – if no image, leave that part blank

Upload bulk options from CSV file

You can also upload your list of options from a csv file. Click the Download csv template link to download an example csv file that you can edit and add your own options.

The example file would look like the image below. Edit that template file to add your list of radio options in the needed format. Save your file with any name you like.

Then click the Upload File button and select your saved csv file. Once your file is uploaded, click the Import button to add all your options to the Bulk Edit area.

Note that uploading options with a CSV file will replace any existing options. If you have existing options already, a notice like below will appear before you import your CSV file.

Use predefined options
Click the Predefined options link to pop open a dropdown where you can select from among the available options:

• Age
• Gender
• Educational Attainment
• Employment Status
• Occupation
• Marital Status
• Continents
• Countries
• American States
• Canadian Provinces

Radio Settings

Require

Select Required to force users to complete this field or Optional to allow users to skip this field if they wish.

Layout

Select to display your radio options in a Vertical or Horizontal layout.

Radio button visibility

If you are using images in your radio options, you can select here to either Show or Hide the radio buttons and labels. If no image is uploaded for any option, the radio button and label will show by default.

Pre-populate

This option enables you to dynamically pre-populate this field with a value passed in your form’s URL. See the Pre-Populate Form Field Values chapter above for details.

Radio Calculations

You can choose whether or not to allow this field to be used to create formulae within Calculations fields in your form. Select Enable to allow the field to be used in calculations.

If you choose to Enable calculations for a Radio field, you must assign a numeric value to each option. Enter the necessary value in the Calculation Value field.

Adds a checkbox field to your form.

Checkbox Labels

Basic Options

Under the Labels tab, you can customize the field Label and add an optional Description.

Then, for each checkbox option, you will need to input the option Label (that your users will see in the form) and its Value (this is what is stored in the database). Note that you can format the options label texts using the HTML text formatting tags. For now, the <strong> and <em> are the only supported tags.

To do that, click the caret icon at the far right of any checkbox option to toggle it open and reveal the additional fields and settings for that option. Or click the Expand All / Collapse All toggle to reveal all settings for all options.

To make any option pre-selected in your form, check the Selected box. Your site visitors will of course be able to change that selection when they fill out the form.

Click on the Add Option area to manually add checkbox options. Click the red trash icon next to any option you would like to delete.

Using Images

If you would like to use images in your checkbox options, check the Enable Images box. That will add an Upload Image button to each checkbox option.

You can customize the layout and label visibility for image options under the Settings tab below.

Your image options could look like this example in your frontend form with checkboxes and labels showing:

You can adjust the colors for the selected state in your form’s Appearance settings.

Bulk Edit

Enable the Bulk Edit feature if you have a large number of options you want to add to your checkbox field. There are 3 ways you can bulk add options to your checkbox field:

• Manually
• Via CSV file
• Predefined options

Any existing options you have already manually created will automatically populate in the Bulk Edit area. If you don’t need those, simply delete them from the Bulk Edit area.

Manually enter bulk options

If you wish to manually enter or paste your list of options in the Bulk Edit area, they must be entered one per line with each term separated by a semicolon, in this order (note that the last term on each line should not be followed by a semicolon):

• Option label;
• Option value;
• Selected; – only one option can be set as selected and should be designated with the number 1
• Image URL – if no image, leave that part blank

Upload bulk options from CSV file
You can also upload your list of options from a csv file. Click the Download csv template link to download an example csv file that you can edit and add your own options

The example file would look like the image below. Edit that template file to add your list of checkbox options in the needed format. Save your file with any name you like.

Then click the Upload File button and select your saved csv file. Once your file is uploaded, click the Import button to add all your options to the Bulk Edit area.

Note that uploading options with a CSV file will replace any existing options. If you have existing options already, a notice like below will appear before you import your CSV file.

Use predefined options
Click the Predefined options link to pop open a dropdown where you can select from among the available options:

• Age
• Gender
• Educational Attainment
• Employment Status
• Occupation
• Marital Status
• Continents
• Countries
• American States
• Canadian Provinces

Checkbox Settings

Require

Select Required to force users to complete this field or Optional to allow users to skip this field if they wish.

Layout

Select to display your checkbox options in a Vertical or Horizontal layout.

Checkbox visibility

If you are using images in your checkbox options, you can select here to either Show or Hide the checkboxes and labels. If no image is uploaded for any option, the checkbox and label will show by default.

Pre-populate

This option enables you to dynamically pre-populate this field with a value passed in your form’s URL. See the Pre-Populate Form Field Values chapter above for details.

Checkbox Calculations

You can choose whether or not to allow this field to be used to create formulae within Calculations fields in your form. Select Enable to allow the field to be used in calculations.

If you choose to Enable calculations, you must assign a numeric value to each option. Enter the necessary value in the Calculation Value field. Note that if users select two or more options in the same checkbox field, the values are added together, and the sum will be the value used in subsequent calculations for the field.

Adds a field to your form that calculates numeric user inputs using custom mathematical formulae.

Calculations Labels

In the Labels tab, you can change the field Label, apply Placeholder text, or add a custom Description.

Calculations Settings

The Settings tab allows you to adjust various aspects of the Calculations field functionality, including field type and formatting.

By default, the Calculations field is read-only. To also hide the Calculations field, check the Hidden checkbox.

To add a prefix or suffix to values entered into the field, enter a prefix and/or suffix into the respective field(s).

Choose your preferred decimal separator from the Separators drop-down menu. To round the field’s value automatically, choose the maximum number of decimal places from the Round To drop-down menu.

Calculations Tab

The Calculations tab is where you input the formula you want to employ for this field, using the merge tags for any fields in your form that you enabled for calculations (Number, Radio, Checkbox, Select & Currency fields can be used in calculations).

Formulae can be simple, such as fieldname1+fieldname2, or complex mathematical equations with multiple grouped fields, such as fieldname1*(fieldname2+fieldname3). Each formula is considered a single calculation, and by inserting multiple calculation fields, your form becomes a powerful mathematical tool.

A handy menu of common mathematical operand shortcuts, located at the top of the formula field, greatly simplifies the construction of your custom formulae. The first option opens a drop-down menu of the numeric value fields inserted in the current form. Combine these fields with the mathematical operands +, -, *, /, and () to create custom formulae.

After adding your formula to the Calculation Formula field, a preview of the formula will appear so you can verify that the proper data and mathematical operation(s) will be used in making this calculation.

In addition to the common shortcuts shown, there are several other operands that this field supports that you can use in your formulae. Please note that, as you cannot type these operands directly into the formula field, you must type up your formula in a plain text file, then copy/paste it into the formula field.

• ^ – Use for exponentiation. Ex: 3^2
• % – Use to find the Modulo Remainder of two field values. Ex: {number-1}%{number-2}
• abs() – To use the absolute value of a form field. Ex: abs({number-1})
• avg() – To calculate the average of two or more numbers. Ex: avg({number-1},{number-2})
• min() – Uses the smallest of two or more field values. Ex: min({number-1},{number-2}) would return the value of {number-2} if less than {number-1}
• max() – Uses the largest of two or more field values. Ex: min({number-1},{number-2}) would return the value of {number-2} if greater than {number-1}
• pi – Returns the value of π (pi)
• ceil() – Rounds the value of a number up to the nearest whole integer
• floor() – Rounds the value of a number down to the nearest whole
  integer
• round() – Rounds the value of a number up or down to the nearest whole integer

Adds a dropdown select field to your form. You can choose from a single select dropdown or a dropdown that allows multiple selections.

Select Labels

Basic Options

In the Labels tab, you’ll want to first choose to make your Select field accept either a Single choice, or Multiple choices.

If you choose Single, you can optionally enter a custom Placeholder that displays in the field before the user makes a selection.

You can then customize the field Label and add an optional Description.

Then, for each selectbox option, you will need to input the option Label (that your users will see in the form) and its Value (this is what is stored in the database).

To do that, click the caret icon at the far right of any selectbox option to toggle it open and reveal the additional fields and settings for that option. Or click the Expand All / Collapse All toggle to reveal all settings for all options.

To make any option pre-selected in your form, check the Selected box. Your site visitors will of course be able to change that selection when they fill out the form. Note that if you make an option Selected here, that overrides the custom Placeholder you may have set above, and it will not appear in your selectbox

Click on the Add Option area to manually add selectbox options. Click the red trash icon next to any option you would like to delete.

Bulk Edit

Enable the Bulk Edit feature if you have a large number of options you want to add to your select field. There are 3 ways you can bulk add options to your select field:

• Manually
• Via CSV file
• Predefined options

Any existing options you have already manually created will automatically populate in the Bulk Edit area. If you don’t need those, simply delete them from the Bulk Edit area.

Manually enter bulk options

If you wish to manually enter or paste your list of options in the Bulk Edit area, they must be entered one per line with each term separated by a semicolon, in this order (note that the last term on each line should not be followed by a semicolon):

• Option label;
• Option value;
• Selected – only one option can be set as selected and should be designated with the number 1

Upload bulk options from CSV file

You can also upload your list of options from a csv file. Click the Download csv template link to download an example csv file that you can edit and add your own options.

The example file would look like the image below. Edit that template file to add your list of selectbox options in the needed format. Save your file with any name you like.

Then click the Upload File button and select your saved csv file. Once your file is uploaded, click the Import button to add all your options to the Bulk Edit area.

Note that uploading options with a CSV file will replace any existing options. If you have existing options already, a notice like below will appear before you import your CSV file.

Use predefined options

Click the Predefined options link to pop open a dropdown where you can select from among the available options:

• Age
• Gender
• Educational Attainment
• Employment Status
• Occupation
• Marital Status
• Continents
• Countries
• American States
• Canadian Provinces

Select Settings

Require

Select Required to force users to complete this field or Optional to allow users to skip this field if they wish.

Search

Enable this option to include a search field in your selectbox dropdown. Note that if you have set a custom Placeholder as above, that placeholder will also appear in the search field.

Limit Submission

This option enables you to set a limited number of times any option in your select field can be submitted by your users.

When enabled, you’ll see an additional setting appear under the Labels tab for each option you add to your select field. Once the limit you enter for any option is reached, that option will be hidden from your select field so users can’t select it.

Pre-populate

This option enables you to dynamically pre-populate this field with a value passed in your form’s URL. See the Pre-Populate Form Field Values chapter above for details.

Select Calculations

You can choose whether or not to allow this field to be used to create formulae within Calculations fields in your form. Select Enable to allow the field to be used in calculations.

If you choose to Enable calculations, you must assign a numeric value to each option. Enter the necessary value in the Calculation Value field. Note that if your Select field is of the Multiple type and users select two or more options, these values are added together, and the sum will be the value used in subsequent calculations.

Adds a datepicker field to your form.

Datepicker Labels

In the Labels tab, you can choose between three different calendar types.

• Calendar with selectable dates
• Dropdowns for day, month and year
• Text input for day, month and year

You can change the Field Label, add Placeholder text and show a calendar icon (Calendar only), or add a custom Description.

You can also select the specific output format of the dates using any of the available presets:

• Y-m-d – ex: 2020-12-31
• m-d-Y – ex: 12-31-2020
• d-m-Y – ex: 31-12-2020
• Y/m/d – ex: 2020/12/31
• m/d/Y – ex: 12/31/2020
• d/m/Y – ex: 31/12/2020
• Y.m.d – ex: 2020.12.31
• m.d.Y – ex: 12.31.2020
• d.m.Y – ex: 31.12.2020

The Dropdowns and Text Input options also allow you to customize the field Labels and Placeholders (Text Input only).

Below are examples of how each calendar type option would look in your form.

Datepicker Settings

If you select Calendar or Dropdowns as the datepicker type, you can set a default date to display in the datepicker field. Select either Today or enter a Future Date; select None if you don’t want a default date to appear in the datepicker.

Datepicker Limits

When you select the Calendar type, you can specify date ranges, specific dates, or days of the week that are available or blocked off in the datepicker field.

Start & End date

• No Limit – Select this option to have the calendar year start & end 100 years before & after the current year.
• Specific Date – Select the date you wish the datepicker to start or end at.
• Today – Select this to have today’s date be used as the datepicker start or end date. You can also offset from today’s date any number of days, months or years, forward or backward.

Days of the week

• All Days – When this option is selected, all weekdays are available for selection in the datepicker field.
• Selected Days – Enables you to specify which weekdays should be available for selection.

Disable Dates or Date Ranges

These options enable you to enter specific dates or whole date ranges that should not be available for selection in your datepicker calendar.

Adds a timepicker field to your form.

Timepicker Labels

In the Labels tab, you can choose between two different time formats.

• Dropdowns
• Number Inputs

You can also specify if you’d like to use 12 hour or 24 hour time, and customize the Field Label and Description.

Open the subfields if you wish to customize the Label and Placeholder for hours and minutes.

Timepicker Settings

Time Increments

Whether using Dropdowns or Number Inputs, you can set the hour and minute increments by which the user can select the desired time.

For example, if you set the increment for hours to “1” and the increment for minutes to “30”, the time can be selected on any hour, and the minutes will be either “0” or “30”.

Time Limits

You can set a start and end time for your timepicker so only times between those limits can be selected.

Default Time

You can set a default time to populate the field if it is left blank.

Adds a file upload field to your form.

File Upload Labels

In the Labels tab, you can select whether your upload field should allow for only a single file or multiple files. You can also customize the Field Label and add a custom Description.

Below are previews of how the Single and Multiple file upload fields could look in your form.

File Upload Settings

Allowed file types

By default, your users can upload any type of file allowed by WordPress, but you can restrict that to only selected file types here.

To limit the accepted file types, select the custom option and you will have access to a list of image, document, audio, video, archive, text, spreadsheet and interactive file types. Uncheck the file types you do not want to allow to be uploaded through this field.

Limit number of files

If you have enabled the Multiple file upload option under the Labels tab, this option will be available so you can restrict the number of files that can be uploaded using this field. Select the Custom option and enter the desired limit.

Filesize Limit

Set the maximum allowed size for any file uploaded through this field in your form. You can set this to any value lower than what is already defined as the upload_max_filesize for your site. If you need to increase that limit, you’ll need to make that change in your server settings. Need help? Follow this guide: Increase file upload size.

Note that if you have enabled the Multiple file upload option under the Labels tab, this setting will apply to each uploaded file, and you’ll see the option is named: Filesize limit per file

Upload method

If you have enabled the Multiple file upload option under the Labels tab, you can choose which method to use for file uploads.

• Ajax – This option will upload the files as the user selects them, and can be a good option to reduce server load if the total filesize is rather large and your server has limited resources. Note that the files will be uploaded to your server even if the user does not submit the form, so you may want to consider the option below to avoid abuse.
• On Form Submission – This option will upload all files at the same time, but only when the user submits the form.

Show files in media library

Enable this option if you want files uploaded through your form to be added to your Media Library.

Adds a Post Data field to your form so you can enable your users to create posts on your site from a frontend page.

Post Data Labels

In the Labels tab, you can activate the following Post Data subfields:

• Title – Enables a field in your form that will create the post title when the form is submitted.
• Content – Enables a field in your form that creates the post content.
• Excerpt – Use this field if you want users to be able to manually enter a post excerpt.
• Featured Image – This file upload field automatically adds the uploaded image as the featured image for your post. If you are using the WPMU DEV Smush plugin and have enabled Automatic compression, images submitted here will be optimized before being added to your Media Library.
• Category – Enable your users to select the post category (you can enable an option to allow for multiple categories under the Settings tab).
• Tags – Enable your users to select a post tag (you can enable an option to allow for multiple tags under the Settings tab).
• Custom Fields – Use this option to map input from other fields in your form to custom fields in your posts.

Please note that you need to enable at least one of the Title, Content, or Excerpt subfields for post data to be submitted.

Toggle open any subfield to reveal its labeling options. For the Title, Content and Excerpt fields, you can customize the field label, placeholder and description. For the Featured Image, Categories and Tags fields, you can customize the label and description. (See below for details about the Custom Fields option.)

The image below shows the label options for the Title field; the others are similar.

Custom Fields

The Custom Fields option enables you to map other fields in your form so they write to custom fields you may have in your post_type. You need only enter the name of the custom field in the Label box, and associate that with a selected form field in the Value box.

For example, if you have a custom field created with the popular Advanced Custom Fields plugin named new_text_1, and want a text input field in your form to write to that custom field, you would enter new_text_1 as the Label for the Custom Field element in Post Data, and select the form field that should write to it as the Value.

Below is an example of how your frontend post form could look with all above fields enabled, and a text input field added to map to a custom field in the post.

Post Data Settings

Post Type

By default, the Post Data field is set to create a post of the Posts post_type, but you can select any available post_type on your site so the form creates posts of that type instead.

Default Status

You can set to automatically publish the post to the selected post_type, or save the form entry as a draft or pending review.

Default Author

Choose a default author for all submissions though your post form. The default author must be a registered user on your site and his user role must be Author or higher. This user will be used as the post author if you allow for guest submissions.

You can also force the selected user to be always assigned as the post author, whether the user who submits the form is logged-in or not. If you don’t force this and a logged-in user makes a post, he will be set as the author of the post.

Taxonomies limits

Select whether only one of each taxonomy can be selected per submission, or if you wish to allow for multiple category and/or tag selections.

Adds a captcha field to your form.

Forminator includes support for both Google reCAPTCHA and hCaptcha. Either option will protect your website from spam and abuse while letting real people pass through with ease.

• Google reCAPTCHA
• hCAPTCHA

Google reCAPTCHA

To add Google reCAPTCHA to your form, select reCAPTCHA as the Provider in the field settings.

reCAPTCHA Type

Select the type of reCAPTCHA you wish to include in your form. If your selected type has not yet been set up on the Settings > CAPTCHA page, you’ll see this handy prompt with a link to that page so you can get that done first.

Select the v2 Checkbox option to include a familiar checkbox inline in your form. This option enables you to specify the Size and Theme for the checkbox.

This option could look like the following example in your published form:

Select the v2 Invisible option to only display a reCAPTCHA badge on your form page. This option enables you to specify the Theme for the badge.

Selecting the reCAPTCHA v3 option also only displays a reCAPTCHA badge on your form page. This option enables you to specify the Score Threshold below which the verification will fail. Note that the higher you set the threshold, the more likely it is that legitimate submissions will fail.

The v2 Invisible and reCAPTCHA v3 options use advanced risk analysis technology to separate humans from bots and protect your sites from spam and abuse without any need for users to click on “I’m not a robot”. Either captcha option could look like the following example in your published form page:

Language

By default, the captcha field will use the language you set in Settings > CAPTCHA, but you can change that here for any specific form if you wish.

Badge Position

This option only appears if you have selected either the v2 Invisible or reCAPTCHA v3 options above. It enables you to specify where the badge should appear on your form page: bottom-left, bottom-right or inline in the form.

Error Message

Customize the error message that appears if the captcha verification fails.

hCaptcha

hCaptcha enables you to add either a familiar inline checkbox or a message to your form, as seen in the examples below.

To add hCaptcha to your form, select hCaptcha as the Provider in the field settings.

hCaptcha Type

Select the type of hCaptcha you wish to include in your form. If you have not yet set up your hCaptchaAPI keys on the Settings > CAPTCHA page, you’ll see this handy prompt with a link to that page so you can get that done first.

Select the Checkbox option to include a familiar checkbox inline in your form. This option enables you to specify the Size and Theme for the checkbox.

This option could look like the following example in your published form:

Select the Invisible option to only display a message that your form is protected. To comply with global privacy laws, the message includes links to hCaptcha’s Privacy Policy and TOS by default.

The Invisible option uses advanced risk analysis technology to separate humans from bots and protect your sites from spam and abuse without any need for users to click on “I am human”. This option could look like the following example in your published form page:

Language

By default, the captcha field will use the language you set in Settings > CAPTCHA, but you can change that here for any specific form if you wish.

Error Message

Customize the error message that appears if the captcha verification fails.

Adds a HTML field so you can insert HTML into your form. This only displays formatted HTML within the form. It is read-only by default and is not for user input.

In addition to HTML code, form data can be embedded into the HTML field through the use of merge tags. To add form data to the HTML field, click the form data icon to select and insert available merge tags. Alternatively, you can type out the merge tag directly.

See Form Data above for more information about embedding form data using merge fields.

Note that if you want to use shortcodes in a HTML field to include custom content in your form, you’ll need to first add the following filter in a mu-plugin or in your child-theme’s functions.php file.
add_filter( 'forminator_replace_variables', 'do_shortcode' );

Adds a page break to your form so you can add steps or break up long forms into sections.

Example of a paginated form on the Frontend:

Pagination Labels

The Page Break fields themselves have no settings, but can dragged & dropped anywhere in your form to break it into pages.

When you add your first Page Break field to a form, you’ll see a Pagination section appear at the top, above all other fields.

Click that section to open the Pagination settings modal. There, you’ll see a label field for that first Page Break you added, and one for the last step of your form. For each additional Page Break field you add to your form, a new page label will appear here for you to customize.

Pagination Settings

Progress Indicator

Choose to show or hide the progress indicator at the top of your form and, if shown, whether it should indicate the steps (as in our example above) or a simple progress bar.

Buttons Text

For each Page Break you add, you can chose to use the default “Previous/Next” button text, or customize those labels for each one.

Adds a hidden field to your form.

Hidden fields are not visible on the front end, so are useful to record something specific on form entry that you don’t need your users to see. This could be something like having the URL of the page the form was submitted from in cases where the form is embedded in a popup, or perhaps some user-specific data you want to use in Visibility conditions in another field.

Hidden Field Labels

Label

You can customize the label of this field in the Field label (again, this only appears in the admin interface, not on the frontend form).

Default Value

The following options are available to select from to use as the Default Value of your Hidden Field:

• User IP Address – The IP address of the user submitting the form.
• Date (mm/dd/yyyy) – The date of the submission in mm/dd/yyyy format.
• Date (dd/mm/yyyy) – The date of the submission in dd/mm/yyyy format.
• Submission Time (hh:mm:ss am/pm, timezone) – The time of the submission formatted as hh:mm:ss am/pm, timezone
• Embed Post/Page ID – The ID of the site page where the form is embedded.
• Embed Post/Page Title – The title of the site page where the form is embedded.
• Embed URL – The URL (permalink) of the site page where the form is embedded.
• HTTP User Agent – The user agent (browser type) of the user submitting the form.
• HTTP Refer URL – The URL of the page where the user came from to get to your form.
• User ID – The ID of the logged-in user submitting the form.
• User Display Name – The WordPress Display Name of the logged-in user submitting the form.
• User Email – The registered email address of the logged-in user submitting the form.
• User Login – The username of the logged-in user submitting the form.
• Custom Value – Can be any custom value you need.
• Query Parameter – Use this to pre-populate this with a value from another form. See Pre-Populate Form Field Values for details.

If you select either Custom Value or Query Parameter for the Default Value, an additional field will appear where you can specify the desired value.

Adds a section divider to your form.

Section Labels

• Section title – Adds a title to your section
• Section subtitle – Adds a subtitle to your section

Section Settings

Optionally add a solid or dotted borderline underneath your section, then specify its width and color.

Adds a Consent checkbox to your form which may be used for compliance with GDPR, for consent to receive marketing emails, and more.

Consent Labels

Customize the field label that appears in your form and edit the text content. Default text is included with a link to your Privacy Policy page set in your site admin Settings and an empty Terms and Conditions link which you’ll want to edit to include the correct link. You can also enter any additional information you need to provide to your users.

Consent Settings

The Consent checkbox is a required field by default, but can be made optional for users. You can also customize the message shown to users if they do not check the box in your form.

Adds a field to your form which allows user-defined monetary inputs, such as when accepting donations.

Currency Labels

In the Labels tab, you can change the field Label, put Placeholder text, add a Default Value or add a custom Description.

Currency Settings

The Settings tab allows you to adjust various aspects of the Currency field functionality, including value limits and formatting.

To force users to fill out the Currency field, select Required. Otherwise, the field will be optional.

It is recommended that any currencies used in a Forminator module remain consistent to avoid confusion. To set the field’s currency, select your preferred currency from the drop-down menu.

To restrict the minimum and/or maximum values that a user can enter, enter a minimum and/or maximum value in the respective fields, and optionally set custom error messages for values beyond these bounds. Leave the fields blank to allow the user to enter any number, including a negative value.

Choose your preferred decimal separator from the Separators drop-down menu. To round the field’s value automatically, choose the maximum number of decimal places from the Round To drop-down menu.

Lastly, to pre-populate the field dynamically using a query parameter passed in your form URL, enter a query parameter key in the Query parameter field.

Currency Calculations

You can choose whether or not to allow this field to be used to create formulae within Calculations fields in your form. Select Enable to allow the field to be used in calculations.

Adds a Stripe payment field to your form. If you’re interested in how this can be implemented for an order form that accepts payments, check out the video below.

Stripe Labels

Under the Labels tab, you can customize the Stripe field Label and optional Description, as well as the preferred Language used for placeholder fields and card validation errors returned by Stripe.

You can also choose whether to show or hide the Card icon in the Stripe field, and whether to require Postal code (or ZIP code) in the Stripe field. If enabled, the postal code can be optionally prefilled from a related postal code field in your form.

The following image shows how Card icon and Postal code options are displayed in the Stripe field, if enabled.

Stripe Settings

The Settings tab allows you to configure payment mode and payment method settings for the Stripe field. Note that you will need to connect a Stripe account to Forminator before customizing Stripe field payment settings.

The Stripe field can be placed in Test mode until your form is ready to process live payments, and can be toggled to Live mode to begin accepting payments. For information about testing Stripe’s payment integration, refer to Stripe’s testing documentation.

Select the Stripe field’s payment currency from the drop-down menu. We recommend using the currency most likely to be used by the majority of your customers in order to minimize currency exchange feeds.

Payment Plans

The Settings tab also allows you to configure one-time and subscription payment plans to be processed by the Stripe field. Multiple payment plans can be configured for the same Stripe field, and conditionally processed based on form data.

Select an existing payment plan to configure payment plan details, or click Add Another Plan to add a new payment plan. Click the trash icon to delete an existing payment plan.

Enter the plan name to be displayed in the form submission and in the Stripe dashboard. For the payment type, select One Time to charge customers a single payment or select Subscription to change customers a recurring payment.

For One Time payments, simply select the plan payment amount: 

• Fixed – Charge all customers the same amount, such as when submitting an application fee or deposit.
• Variable – Change the payment amount depending on form data. If selected, a drop-down menu will appear where you can select an existing Currency or Calculations field in your form to set the plan payment amount.

For Subscription payments, select the plan payment amount and quantity. For both settings, the available options are:

• Fixed – Charge all customers the same amount/quantity, on a recurring basis.
• Variable – Change the payment amount/quantity depending on form data. If selected, a drop-down menu will appear where you can select an existing Currency or Calculations field in your form to set the plan payment amount/quantity.

Whether you set the Quantity to be Fixed or Variable, the total amount that the user will pay equals the number in the Amount field multiplied by the number in the Quantity field. For example, if the Amount is $10 and the Quantity is 3, the user will be charged $30 when submitting the form and a similar amount on the next billing cycle.

For Subscription payments, select your billing cycle and choose whether to allow a free trial period. If a trial is enabled, select a trial duration, in days.

Multiple payment plans can be added to the same Stripe field and conditionally processed based on form data. First, select the Conditions tab, and then select an existing condition to configure condition details, or click Add Conditions to add a new condition.

Then, configure the conditional logic that will determine when to process the selected payment plan. For additional details on conditional logic, refer to our overview of conditional logic in the introduction to the Forminator Fields chapter.

Once customers have submitted forms with a subscription payment plan, your subscribers and subscription payments can be managed from the Stripe Dashboard. Alternatively, you can jump to individual subscriptions in Forminator from the Submissions page by selecting a form submission and clicking Manage subscription.

Stripe Advanced

Payment Receipt

Enable the Payment Receipt feature and Stripe will email a receipt to your customers following successful purchases. This receipt comes directly from Stripe and is in addition to any custom email notifications configured in Forminator.

Click the Email address drop-down menu to reveal the email fields present in the current form and select the applicable email address.

Stripe does not send receipts for purchases conducted in Test mode, only successful live payments will receive receipts.

You can customize the Stripe receipt email by clicking Customize email template, which will open the Stripe login screen. Log in to Stripe and follow their guidance on creating custom email receipts.

Payment Details

Statement Decipher

A Statement Decipher is techie phrase for the word or phrase appearing in a financial account statement that identifies where a transaction occurred. Typically, one would expect this to be the company name but you can create any custom decipher you wish as long it’s no more than 22 characters long.

Payment Description

The Payment Description will appear in the Stripe payment receipt emailed to your customers and will be part of transaction data recorded in the Stripe account that received the payment.

Card Validation

Stripe validates card information as it’s being input and this validation occurs independent of the validation of other user inputs, such as email addresses, as configured under the form’s Behavior tab.

Billing Details

Enable Billing Details to send additional information collected by a form to Stripe so the data appears with the payment information in your Stripe Dashboard. Click Enable, then select from the drop-down menus the information you want Stripe to include with the transaction record.

Meta Data

Any custom metadata associated with your form can be sent to Stripe and included in the MetaData section for each payment received. Any metadata sent to Stripe must conform to the service’s requirements: a maximum of 20 meta keys can be sent, key names must be 20 characters or less and mapped data will be truncated to 500 characters.

Stripe Styling Tab

The element classes on the Stripe checkout screen are associated with a specific field state, such as empty, invalid or complete. When a field’s state changes, usually because a user entered some data, a new class is applied. The Styling tab allows you to create custom classes while maintaining this relationship between classes and field state.

For example, when a user completes a given field with no errors, Stripe associates the default class StripeElement–complete with that field. You may change the class StripeElement–complete by editing the Complete field in the Styling tab, but Stripe will still associate the new class with the “complete” state, and only when a field achieves the “complete” state will styling associated with that class be applied.

Remember, modifying Stripe’s default classes is not necessary, but if you wish to do so, simply enter your custom classes into the fields provided and click Apply.

Click Read More to access the Stripe compendium of element types, objects, classes and styles.

Once you’ve defined your custom classes, or chosen to use the defaults, you can then use the classes to apply custom CSS in the editor available in the Forminator Appearance tab.

SCA Compliance

The Stripe Elements payment process is fully SCA compliant. Strong Customer Authentication (SCA) requires that online credit and debit card payments transacted in Europe use 3D Secure to authenticate payments.

Financial institutions may decline transactions that don’t follow SCA guidelines.

3D Secure, in a nutshell, dictates that verifying a card’s validity is insufficient protection from fraud and requires that customers authenticate each online purchase independently. This is typically accomplished by providing customers with a transaction-specific verification code delivered via email or SMS, similar to the example below.

A message will appear in your WordPress Dashboard following the update which outlines why updating to SCA is critical. Click Learn More to access a window we designed to expedite the process of verifying your forms’ appearance and functionality.

The Stripe is SCA Compliant window suggests things to look for when you are reviewing your forms.

The window identifies your existing forms that contain stripe fields. Click the edit icon on the right to access that form and review the Stripe field.

Adds a PayPal payment field to your form.

PayPal Settings

The first time you access the PayPal field Settings screen, you will be prompted to connect a PayPal business account to Forminator if you haven’t already done so.

Click the here link to be redirected to the Settings > Payments screen in Forminator. There, you’ll click Connect To PayPal to access and connect your Stripe account to Forminator. See the Settings > Payments section if you need help connecting your PayPal account.

Once PayPal is successfully connected to Forminator, you can continue with the configuration of the payment field in your form.

Mode of Payment

Use Sandbox mode to test your PayPal Checkout configuration and ensure it looks and functions as you expect before publishing the form. Select Live mode when you are ready to publish your form and accept payments.

Charge Currency

Open the drop-down menu to select the currency you wish to use with this form. It is recommended that you use the currency most likely to be used by the majority of your customers in order to minimize the negative impact currency exchange fees can have on sales.

Payment Amount

• Fixed – Select this option to set a fixed payment amount if you want everyone submitting this form to pay the same amount, such as when submitting an application fee or deposit.
• Variable – Select this option to make the payment amount dependent on user inputs. A drop-down menu will appear where you can select any Currency or Calculations field in your form to populate the Payment Amount field.

PayPal Advanced

Disable Funding Sources

Select the funding sources you want to eliminate from PayPal displays as payment options.

Disable Card Options

Select the cards you want to eliminate from PayPal displays as payment options.

Pre-fill Billing Details

Billing details collected by your form can be sent to PayPal. These details will appear alongside each payment in your PayPal Dashboard. Click Enable to send billing details to PayPal.

Note that if you select a Name field when enabling this option, that Name field must be set to Multiple (with both First and Last names enabled). Similarly, if you select an Address field, the Country option must be enabled in that field.

If these requirements are not met, you’ll get a very cryptic error from PayPal on your form page when you click the payment button: Error! Something went wrong when verifying the payment.

Shipping Address

If you are selling a product that doesn’t need to be shipped, you can choose to disable and hide the shipping address fields from the PayPal payment page. Click Enable to include shipping address fields on the PayPal payment page.

Language

PayPal automatically adapts the language that appears on its buttons to visitors’ geolocations and browser preferences. You can set a specific language for your PayPal buttons but doing so overrides the PayPal adaptive language feature. The payment buttons will display the language you choose to all visitors.

If you wish to limit your PayPal buttons to a specific language, you must enter a PayPal locale code. Visit PayPal’s Supported locale codes page to find your code, and enter the code in the field provided.

Debug Mode

PayPal debug mode can help troubleshoot issues with the PayPal payment process. However, Debug mode significantly increases script size and can cause performance issues. It is recommended that you enable Debug mode and troubleshoot PayPal issues in Sandbox mode only.

When enabled, pop open your browser console where you’ll see every PayPal process is logged during a transaction to help troubleshoot any issues you may be having.

PayPal Customize

The Customize Tab allows you to modify the look of the PayPal Checkout buttons in your form.

• Label – Choose which of three PayPal labels will appear in your form’s buttons.
• Color – Choose the color of the buttons.
• Width – Chose the width of the buttons.
• Height – Chose the height of the buttons.
• Shape – Choose the shape of the buttons.
• Layout – Choose whether the PayPal and PayPal Credit buttons are stacked or appear side by side.

If you leave everything at their defaults, your buttons would look like this example in your form.

SCA Compliance

The PayPal payment process is fully SCA compliant. Strong Customer Authentication (SCA) requires that online credit and debit card payments transacted in Europe use 3D Secure to authenticate payments.

Financial institutions may decline transactions that don’t follow SCA guidelines.

3D Secure, in a nutshell, dictates that verifying a card’s validity is insufficient protection from fraud and requires that customers authenticate each online purchase independently. This is typically accomplished by providing customers with a transaction-specific verification code delivered via email or SMS, similar to the example below.

Version 1.13 of Forminator introduces a new form field: E-Signature. You can now require users to add their signature when submitting your form.

With all settings at their defaults, the E-Signature field would look like this example in your form.

E-Signature Labels

• Label – This appears above the E-Signature field in your form.
• Placeholder – This appears in the E-Signature field before the user clicks into it to sign.
• Description – This appears beneath the E-Signature field.

E-Signature Settings

• Signature filetype – Select to save submitted e-signatures as PNG or JPG files.
• Height – Adjust the height of the e-signature field if needed.
• Stroke thickness – Adjust the line thickness of the e-signature.
• Require – Set the e-signature to required or optional.

Navigate to Forminator > Polls and click the Create button to begin creating a poll.

In the modal that pops open, enter the name of your new poll and click the Create button.

Questions

Enter the poll Question and add a Description if you wish. Each poll consists of only one question.

You can also add an image that will appear with your poll on your site, like so:

Answers

Click on the Add Answer button to add as many poll answers as you wish.

You can even add a custom input field when you want to allow your visitors to manually enter their answer. For example, you can use this field as an “Other” option. To add a custom input field, select the gear next to the answer you want to convert and select enable custom input.

A new box will appear where you can add placeholder text. When someone selects your custom input option, a field will appear where they will be able to enter their answer. Your placeholder text will appear in this box like so:

You can use images in your poll answers as well. Check the Enable Images checkbox, then click the Upload button next to any answer to add your images.

Note that for consistent image display in your poll, you’ll want to ensure your answer images are all the same aspect ratio. For example: 16:9, 4:3 or 1:1.

Below is an example of what a poll could look like with image answers set to display in 3 columns. You can adjust the layout of your answers under the Appearance tab.

Button

Before proceeding to the appearance of your poll, you can also change the button label of your poll (the default value is Submit):

The Appearance options control a poll’s overall design, its colors and the look of its container.

Design Style

Select the base style you’d like for your poll. The available style options are Default, Flat, Bold, Material, and None.

If you select None, the poll will inherit styles from your theme’s CSS and you will not be able to change colors or the poll container from the Appearance tab. Instead, you will need to make customizations as you usually do for any other custom CSS you add to your site: under Additional CSS in the Customizer, a custom CSS plugin, a custom CSS area in your theme options, or the style.css file of your child-theme.

Colors

For colors you can use the default colors or select custom to access colors for a variety of elements in your poll. Simply open the element you want to change the color for and make your changes.

Layout

If you have enabled images for your poll answers in the Details settings, you can set your image answers to display as a List or in a Grid format.

If you select a Grid layout, an additional setting will appear where you can choose the number of columns to display per row. Note that this will always default to 2 columns on mobile screens.

Whether you select to display answers in a list or a grid format, you can also set the Answer Type and choose to display both the radio button and image for each answer, or just the image.

Form Container

Further customize the appearance of the poll’s main container by adding padding and a border.

Custom CSS

Our Custom CSS option was built in way so you can customize your poll using CSS. We added a lot of selectors for your convenience but if you need help with CSS our 24/7 Live Support will be right by your side.

The Behavior options control what happens when a respondent submits a poll.

Results Display

Control how poll results are displayed, or not, by selecting one of the following options:

• Link on poll – Adds View Results link to the poll which, when clicked, displays results on the same page with a Back to Poll link.
• Show after voted – Automatically displays the poll results when the user submits the poll, with a Back to Poll link as well.
• Do not show – Respondents will not see the poll results. The page will refresh or reload depending the submission method you select below.

If you chose either of the display options above, you can select whether to display results in a pie chart or a bar graph.

Results will display in the selected format when users submit a completed poll.

Vote Count

Choose whether or not to display the number of votes on the results page.

Submission Method

• Reload page – Select this option to reload the page upon submission of a poll if the default ajax loading is causing issues on your site.
• Ajax – This is the default submission method that does not require a page reload.

Vote Opening

Configure settings related to a poll’s voting status, including when voting should open and/or close, and the messages displayed to users when voting is closed, paused, and not yet open:

• Status – Select whether voting in the poll is open, paused, or closed.
• Open From – Select the date at which voting in the poll will open, otherwise voting will be opened immediately.
• Open Until – Select the date at which voting in the poll will close, otherwise voting will be open indefinitely.
• Custom Messages – Enter custom messages that should be displayed to users when voting is closed, paused, and not yet open.

Voting Limit

• Limits – By default, your visitors will be able to vote only once. If you want to adjust this behavior, you can let them vote unlimited times by not entering any values (this is most useful for testing purposes). You can set a limit so your visitors need to wait a certain number of minutes, hours, days, weeks, months or years before they can vote again.
• Method – Choose whether Forminator should identify users who have already submitted a poll by their IP addresses or by placing a browser cookie.

Security

This section allows you to protect your poll.

• Enable Akismet spam protection – If you are using the Akismet plugin on your site, you can enable this option, and select to either fail any submissions that Akismet detects as spam, or simply mark them as spam. Selecting the Fail Submissions option would display a customizable message to the user, and Mark as Spam would log them in your database but they would not appear in your Submissions list.

Rendering

This lets you choose how to render your poll to accomodate cache plugins that may cause issues to your dynamic polls.

• Load poll using AJAX – will do just that in order to avoid any cache issues that may arise because of plugins that have Page Cache ability.
• Prevent page caching on poll pages – Select this option to automatically add the DONOTCACHEPAGE constant to any page with this poll embedded in it. Cache plugins like WPMU DEV Hummingbird will respect that directive and not cache your poll page.

Email notifications can be configured in the poll’s Email Notification tab, enabling custom emails to be sent to admins or users upon poll submission.

To add an email notification, first toggle on Send an email to admin users.

Then, configure the email fields as desired.

Poll Data

Poll data can be included in your notification email subject and body, as well as the from name, through the use of merge tags.

Merge tags can be inserted for any of the following pieces of poll data:

• Poll Name – Use the {poll_name} merge tag
• Poll Answer – {poll_answer}
• Poll Result – {poll_result}
• User IP Address – {user_ip}
• Date (mm/dd/yyyy) – {date_mdy}
• Date (dd/mm/yyyy) – {date_dmy}
• Embed Post/Page ID – {embed_id}
• Embed Post/Page Title – {embed_title}
• Embed URL – {embed_url}
• HTTP User Agent – {user_agent}
• HTTP Refer URL – {refer_url}
• User ID – {user_id}
• User Display Name – {user_name}
• User Email – {user_email}
• User Login – {user_login}
• Custom Value – {custom_value}
• Query Parameter – {query} – Please ignore this tag as it serves no purpose for emails and will be removed from these options shortly.

Where supported, click the poll data icon or [+] icon to select and insert available merge tags. Alternatively, you can type out the merge tag directly.

For example, the following subject line includes the merge tag {poll_name}, representing the name of your poll:

New Poll Entry for {poll_name}

Accordingly, an email notification sent upon poll submission would read as “New Poll Entry for My Poll”.

You can also use standard HTML tags in the email body when editing in Text mode. However, just like when editing regular WordPress posts, some tags may be stripped out if you switch to Visual mode.

From Name

Enter the name from which the email notification should be sent, or click the [+] icon to select and insert an available merge tag. Alternatively, you can type out the merge tag directly.

From Address

The From Address must be the default site email address or a domain email. Click the drop-down menu and begin typing the desired email address into the field. The available email addresses matching your inputs will appear for selection.

Recipients

Only admin email addresses can receive poll notifications. Add email addresses into the field provided, adding as many admin addresses as necessary.

Reply To Address

Optionally add a reply-to address that can be any valid email address.

CC & BCC Addresses

Optionally add any CC and/or BCC email addresses you need to your notifications.

Subject/Body

Enter a custom subject line and a custom message into the fields provided. Use the editor to format the message just as you would any other content.

Third-party apps connected to Forminator will appear hear. Click the plus [+] icon next to any connected app to activate an app for the current poll. The app will be authorized to collect data from the poll submissions.

You can connect as many apps as you need, and as many instances of each app, to any poll.

To see how to configure these integrations follow the links here:

• Google Sheets
• Slack
• Trello
• Zapier

The Settings options control how Forminator stores and protects submission data.

Data Storage

Your poll submission data is stored in your site database, by default. Disable this storage with the toggle.

Be sure to configure alternate storage with a third-party integrated app before disabling local storage if you do need to keep this data somewhere.

Privacy

Submissions

To save your data in your database temporarily, you can specify when you would like the data to be auto deleted.

IP Retention

Each time your visitors vote, Forminator will save their IP address in your database (this is used to prevent multiple votes by one visitor and to modify vote limitations). In case you need to release this data (due to GDPR or any local law) you can change the IP retention settings here.

Preview

Just like with forms, you can always preview your poll by clicking on the Preview button in the sidebar menu of any Polls screen.

You’ll be able to see how your poll will appear on your site, including the changes you make to the appearance.

Each poll comes with a shortcode which you can use to embed it anywhere on your site where shortcodes can be used: pages, posts, widgets, etc.

Any time you click the Publish button for a poll in the editor, a modal will pop open to show you the shortcode for that poll.

To get the shortcode for any poll after having published it, go to the Forminator Polls page. Find the poll you’d like to use and select the gear icon to open the settings dropdown for the poll.

Select Copy Shortcode, which will automatically add the shortcode to your clipboard so you can paste it anywhere.

You can also add a poll to your post while in the WordPress editor. In the Classic editor, click the Form button next to the media uploader button.

Then select the poll you want to embed in the modal that pops open.

In the Gutenberg editor, click the [+] icon to add a new block, and find the Poll block.

Once the block is added, select the poll you want to embed in the post.

In case you want to present your poll in a Widget, navigate to Appearance > Widgets, drag the Forminator Widget to your sidebar or another widget area, choose the poll you would like to display and press on the save button:

Navigate to Forminator > Quizzes and click the Create button to begin creating a quiz.

The first step is to give your quiz a name. Then, you can choose one of the two general quiz types that best serves the goals for the current quiz.

• Knowledge – A quiz with as few or as many questions and answers as desired. Questions must have a correct answer, and scores/results are calculated based on the number of correct answers submitted. Also called a Graded quiz.
• Personality – An “outcome” quiz in which there are no right or wrong answers; the user’s answers are tallied up and the result is calculated based on your preset outcomes for each possible response to each question.

Select a quiz type, and click Continue.

Then select whether you want your quiz to be paginated or not. If you select Paginate Quiz here, you can adjust the pagination settings under the Behavior tab.

Next, you can choose whether or not you want to collect leads on your quiz. This essentially allows you to collect participants’ data such as names or email addresses.

Most of the options for the two quiz types are identical, so we’ll go through each in turn below, and highlight the differences where applicable.

Options in this section are identical for both quiz types.

• Title – The title that will display above the quiz. It can be left blank, if you wish.
• Feature image – Optionally add a featured image that will appear above your quiz.
• Description – Further describe your quiz and to explain to your visitors what they are about to take on.

Note that the Description field allows you to use merge tags to dynamically populate your message with any available data if needed. Just click the Add Form Data button and select the value(s) you need.

If all above options are filled in, your quiz intro could look something like the preview example below.

If you have selected to create a Personality Quiz, you’ll see this section available where you set up the end results of your quiz. Once they’re set up, you can get to creating the questions and answers that lead up to these results.

Note that “personalities” don’t actually need to be personalities. You can use this type of quiz to build any quiz where you need the outcome to be one of your preset results, which depend on user answers. So instead of personalities, your quiz outcomes could be anything, like seasons, destinations, meal preferences, etc.

As a simple example, you could have a single question like “Which color is more you?”. Then the user could select from 3 possible answers: Red, Green or Yellow. Depending on the color selected, the outcome (the personality) could be Apple, Avocado or Banana.

Click the Add Personalities button to get started on your first desired outcome.

In the modal window that pops up, enter the Title for your outcome (required), and optionally include an Image and a Description.

The same modal popup will appear when you want to edit an existing personality. Either click directly on the personality name itself, or click the gear icon to open a menu with the Edit option. That menu also has options to Delete or Duplicate a personality, which can be handy if you’re creating several similar ones.

If all above options are filled in, your quiz result could look something like the preview example below.

Repeat this process and add as many questions and answers as you wish to your quiz. Once all questions have been answered, the result with the highest score will be calculated and presented to the visitor.

Note that if you have an even number of questions, the result of the quiz might be even as well, so just make sure to sort your results by priority. Top personality will always be chosen if the end result is equal.

Options in this section are identical for both quiz types, with one exception: how the answer is used to calculate the quiz result.

Adding a Question

Click the Add Question button to get started with your first question.

In the modal window that pops up, enter the Title for your question (required), and optionally include an Image and a Description.

Then click the Add Answer button to add your first answer to this question.

Adding an Answer

Here’s where things differ slightly in this section, depending on which type of quiz you’re creating.

Personality Quiz

If you’re building a Personality quiz, you’ll associate each answer in your question with one of the Personalities you created earlier by selecting it from the dropdown. You can select only one Personality for each answer.

Knowledge Quiz

If you’re building a Knowledge quiz, you’ll identify the correct answer(s) for your question by checking the checkbox. There can be multiple correct answers for each question.

Submit Button

To edit properties of the Submit button, click on the gear icon to access the options.

In the modal window that pops open, you can customize the submit button text, the message that displays while the quiz is submitting, and add any custom CSS classes you might want to style the element in your stylesheets.

The Leads section allows you to configure how your embedded lead form will appear and behave in your quiz. When Leads are enabled, they allow you to collect information from users such as names and email addresses.

If a lead form is embedded in a quiz, it looks a little something like this:

In the example above, we have chosen to include the Email Address, Name, and Consent fields and have set the lead to appear just before the quiz results.

All leads form data can be accessed in the Submissions tab for the associated quiz.

Check out the video below for more information.

Capture Leads

You can edit your lead capture by changing the following aspects that are discussed in the sections below:

• Lead generation form
• Form Placement
• Skip Form

Lead generation form

We have provided a default lead generation form for your convenience but this can easily be edited. Click on the pencil icon to jump to the Forms tab where you can customize the lead form in the same way that you would any other form generated with Forminator.

This lead form will not show up under your Forms tab like your other forms, as it is internally linked to the quiz and is not a standalone form. You will also notice that the Email Notifications and Integrations of the lead form will not be editable. This is because they are shared between the lead form and the parent quiz. The Email Notifications and Integrations can be edited for both in the configuration module for the quiz.

Form Placement

Choose whether you want the embedded lead form to appear at the beginning of your quiz or before showing the results.

Skip Form

Enable this feature if you want to give participants the option to skip your lead form. If this is enabled, you can customize the link text to better fit your quiz.

Options in this section are identical for both quiz types.

Design Style

Select the base style you’d like for your quiz. The available style options are Default, Flat, Bold, Material, and None.

If you select None, the quiz will inherit styles from your theme’s CSS and you will not be able to change colors or the quiz container from the Appearance tab. Instead, you will need to make customizations as you usually do for any other custom CSS you add to your site: under Additional CSS in the Customizer, a custom CSS plugin, a custom CSS area in your theme options, or the style.css file of your child-theme.

Colors

By default, your quiz will inherit your theme colors, but you can completely customize every part of it by clicking on the Custom tab which will allow you to edit colors of your Quiz, Answers, Buttons, Results and Social Share icons.

Click on any element you wish to customize and enter the color hex code for the option you wish to customize, or click the Select button to use the handy color-pickers.

Fonts

By default, your quiz will inherit your theme fonts, but you can completely customize every part of it by clicking on the Custom tab which will allow you to edit the fonts for your Quiz, Answers, Buttons, Results and Social Share icons.

Click on any element you wish to customize and select the font family you wish to use for that element, then set the font-size and font-weight if desired.

Layout

Answers

• List – Select this option to have each of your quiz answers appear stacked one on top on the other in a list format.
• Grid – Select this option to have your quiz answers appear in a grid format.

If you select the Grid option, you can specify the number of columns per row that the answers should display in. Note this only affects devices with screens greater than 782px in width; on smaller screens, the answers will stack in list format by default.

Quiz Alignment

Set the overall alignment of your quiz to left, centered or right. Note this option affects everything inside the quiz container: title, description, images, questions and answers, buttons, and social share message.

Question Item Ordering

This option enables you to change the default top-to-bottom order of the Question and optional Description & Image. Drag and drop the items into the order you prefer.

Quiz Container

Here, you can customize various aspects of the quiz container’s appearance.

• Padding – Optionally add padding to any side of the quiz container to give things a bit more breathing room if needed.
• Border – Add a border if you wish and adjust the corner radius, border thickness and style.
• Spacing – Allows to adjust the spacing between quiz questions using the default presets, or enter your own custom spacing value in pixels.
• Maximum Width – Select full-width to have your quiz fill the available width of the container it displays in, or set the maximum width you want your quiz to display at. Note that your quiz width will automatically adjust on mobile devices with screens smaller than the max-width you set here and will not bleed off the screen.

Custom CSS

If you wish to customize the appearance of your quiz beyond what is available in the above options, you can enable the Custom CSS option and have at it. A number of preset buttons are available at the top to help you quickly add the CSS selectors you need for those elements. For any other elements you want to target, you would need to use your browser’s developer tools to locate the needed selectors.

Options in this section are identical for both quiz types, except for Results and Messages options, which only appear in a Knowledge Quiz.

Questions

If you select to have a Paginated Quiz, you can set the following options:

• Number of questions per page – Set this to to display one or more questions per page. Users can advance to the next page only once all questions on the current page have been answered.
• Start quiz button text – Customize the text on the Start Quiz button. This displays just below your quiz Intro, before the user starts the quiz.
• Previous button text – Customize the text on the Previous Page button.
• Next button text – Customize the text on the Next Page button.
• Show page indicator – Show or hide the Page 1 of X indicator.

The image below is an example of what a quiz could look like with pagination set to display only one question per page:

Results (Knowledge Quiz only)

Display Method

There are two ways to display results to users when they select answers in your quiz:

• Real Time – Displays the correct answer immediately when they make their selection for a question.
• On Submission – Displays the correct answers for all questions only once the quiz is submitted.

If you select the Real Time method, your users will be able to select only one answer to a quiz question, even if you have set more than one correct answer for that question.

You can also optionally choose whether to show a loading spinner when a user selects an answer. This is recommended on long quizzes as it may take a bit longer to evaluate an answer.

If you select the On Submission method, your users will be able to select multiple answers for each of your quiz questions.

Messages (Knowledge Quiz only)

• Correct Answer Message – This message appears when the user has correctly answered a question.
• Incorrect Answer Message – This message appears when the user selects an incorrect answer.
• Final Count Message – This message appears at the end of the quiz, at the bottom, with the final count of correct answers. You can even take your quiz to the next level by adding some shortcode here. Embed WooCommerce product recommendations, a poll, or whatever else you may want.

Social Sharing

Enable this option if you want to allow the quiz participants to share their results on social media. Shared results will include a link back to the user’s quiz results on your site.

You can enable any of the following social media platforms:

• Facebook
• Twitter
• LinkedIn

Rendering

• Load quiz using AJAX – Enabling this option will load the quiz via Ajax after the page itself has loaded, effectively speeding up the page load, and can help avoid page cache issues.
• Prevent page caching on quiz pages – Enable this option to disable page caching on any page that contains this quiz.

Email notifications can be configured in the quiz’s Email Notification tab, enabling custom emails to be sent to admins or users upon quiz submission, with emails routed based on quiz data.

To add an email notification, click Add Email Notification.

Quiz Data

Quiz data can be included in your notification email subject and body through the use of merge tags.

Merge tags can be inserted for any of the following pieces of quiz data:

• Quiz Name – Use the {quiz_name} merge tag
• Quiz Answer – {quiz_answer}
• Quiz Result – {quiz_result}
• User IP Address – {user_ip}
• Date (mm/dd/yyyy) – {date_mdy}
• Date (dd/mm/yyyy) – {date_dmy}
• Embed Post/Page ID – {embed_id}
• Embed Post/Page Title – {embed_title}
• Embed URL – {embed_url}
• HTTP User Agent – {user_agent}
• HTTP Refer URL – {refer_url}
• User ID – {user_id}
• User Display Name – {user_name}
• User Email – {user_email}
• User Login – {user_login}
• Custom Value – {custom_value}
• Query Parameter – {query} – Please ignore this tag as it serves no purpose for emails and will be removed from these options shortly.

Where supported, click the quiz data icon or [+] icon to select and insert available merge tags. Alternatively, you can type out the merge tag directly.

For example, the following subject line includes the merge tag {quiz_name}, representing the name of your quiz:

New Quiz Entry for {quiz_name}

Accordingly, an email notification sent upon quiz submission would read as “New Quiz Entry for My Quiz”.

You can also use standard HTML tags in the email body when editing in Text mode. However, just like when editing regular WordPress posts, some tags may be stripped out if you switch to Visual mode.

Options in this section are identical for both quiz types.

Third-party apps connected to Forminator will appear hear. Click the plus [+] icon next to any connected app to activate an app for the current quiz. The app will be authorized to collect data from the quiz submissions.

You can connect as many apps as you need, and as many instances of each app, to any quiz.

To see how to configure these integrations follow the links here:

• Google Sheets
• Slack
• Trello
• Zapier

Options in this section are identical for both quiz types.

Data Storage

Your quiz submission data is stored in your site database, by default. Disable this storage with the toggle.

Be sure to configure alternate storage with a third-party integrated app before disabling local storage if you do need to keep this data somewhere.

Privacy

To save your data in your database temporarily, you can specify when you would like the data to be auto deleted.

The Stripe Subscriptions add-on expands Forminator’s Stripe fields with the added option to create subscription payment plans.

Watch the introductory video below to get a feel for how the addon works, then see the Stripe Field documentation above for details on configuring subscription payment plans.

ForstressDB is a plugin centered around data privacy, security and speed. It is especially useful for protecting sensitive information and being able to display data on your site efficiently.

To start, make sure you have activated the FortressDB plugin on your site and logged into your account.

You will notice that FortressDB appears under Applications in the Integrations tab for Forminator. If the login to FortressDB has not been completed, it will appear under Available Apps with the plus icon to the right.

If you click the plus icon, a pop-up message will indicate that it is not connected properly and will provide a link to the FortesssDB plugin login page.

Once the FortressDB login has been successfully completed, it will appear under Connected Apps with the gear icon for configuration.

FortressDB does not require any further configuration. To connect a form to FortressDB, you need only go to the Integrations tab of the specific form where you’ll see FortressDB in the Connected Apps section of the list. Click the plus icon to open the integration options and click Connect.

The form will then be connected to FortressDB and a table will be created under Secure Forms in the FortressDB plugin for data pertaining to that form.

We will make a simple example here and presume that your form has First Name and Email address fields. For the integration to work you need to have these fields in the Mailchimp Audience as well, so let’s first create that.

Go to your Mailchimp account, click on the Audience icon, and then on the Audience dashboard tab.

From there, click on the Current audience dropdown menu, or if you have one audience, click on the Manage audience dropdown. With whichever menu is relevant to your setup, select View audiences.

Then click Create Audience in the top righthand corner.

Fill out all the necessary fields, as per your needs, and then check Enable double opt-in if you want your users to confirm, via their email, subscription to your Audience. If you don’t check this field, users will get auto-subscribed to your Audience.

Once the Audience is created, create the necessary input fields, using Audience fields and Merge tags, so Forminator can send your inputted data to those fields in Mailchimp.This is found under the Settings dropdown menu, in Audience fields and *|MERGE|* tags.

Add the same fields (and types) that you have in your Forminator Form. The Email field is the only field that is required. Name fields are also good practice so you can easily distinguish your users.

The fields you added here will accept data your users filled out via your connected Forminator Forms.

Now to get Mailchimp integrated with Forminator, go to the main Integrations screen in Forminator and click the [+] icon for Mailchimp.

In the new pop-up window, whilst logged in to your MailChimp account, click here so you can get your API Key.

Copy the generated API Key and paste it in the API Key line of your form, and choose an identifying label for the connected account.

Once done, click on the Connect button. You have now created a connection to your MailChimp account.

To connect a form to your Mailchimp account, you need only go to the Integrations tab of the specific form where you’ll see Mailchimp in the Connected Apps section of the list. Click the [+] icon to open the integration options.

In the new pop-up, choose your desired Email Audience (List) and check if you want to use Double Opt-in (which forces your visitors to confirm their subscription, via their email, to your selected Emailing list). If Double Opt-in is not selected here, once the form is submitted the data visitor provided will be auto-added to your mailing list (basically signing them up).

Click Next to continue.

If desired, you can use your existing Mailchimp tags to help organize your audience. Enter as many tags as you’d like to the Tags text field, and then click Next to continue.

If desired, you can also use your existing Mailchimp groups to help categorize your audience based on their interests. Select an existing group category from the dropdown menu, and then select the intended interests. Click Next to continue.

On the left side you can see the fields present in your selected Mailchimp Audience and on the right side the fields available in your current Forminator Form. Match the fields, if not already matched, so their data is sent to the right ones in Mailchimp, and then press Save.

This concludes your Mailchimp integration. From now on all the data, from the forms you have chosen to set this up, will be also sent to your Mailchimp Audience :)

Using Campaign Monitor as your email marketing service? Let’s quickly go through how can you connect your Form to it. Click the [+] icon for Campaign Monitor.

This will bring the connection pop-up where you need to enter your Campaign Monitor API Key and Client ID, as well as an identifying label for the connected account.

In order to get those, login to your Campaign Monitor account and then navigate to Account Settings/API keys:

Click on Show API Key and then copy/paste both the API Key and the Client ID to the Forminator pop-up we mentioned at the start:

Once done, click on the Connect button. You have now created a connection to your Campaign Monitor account.

To connect a form to your Campaign Monitor account, you need only go to the Integrations tab of the specific form where you’ll see Campaign Monitor in the Connected Apps section of the list. Click the [+] icon to open the integration options.

In the popup that appears, name your connection (put any name you wish as this is just for you):

Once the connection is made, click the Next button and then choose the Campaign Monitor list where you wish the submitted data of your form to go to:

Now you need to assign fields, in order for your form data to populate your chosen Campaign Monitor list. Take note that both the email and the name fields are required by Campaign Monitor and the rest are optional:

The last step allows you to additionally configure your Campaign Monitor connection, so let’s see what you can do here:

• Re-subscribe – If the subscriber is in an inactive state or has previously been unsubscribed or added to the suppression list and you enabled Re-subscribe, they will be re-added to the list. Therefore, this options should be used with caution and only where suitable. If Re-subscribe is disabled, the subscriber will not be re-added to the active list.
• Restart Subscription based Autoresponders – By default, resubscribed subscribers will not restart any automated workflows, but they will receive any remaining emails. However, if you enable the Restart Subscription based Autoresponders, any sequences will be restarted. Restart Subscription based Autoresponders only affects resubscribing subscribers.
• Consent to track – Whether or not the subscriber has consented to have their email opens and clicks tracked. This value applies to all subscribers with the same email address, within the same client. If an email address has no value stored for Consent to Track, it is assumed that the subscriber has given consent. You can find more information at Campaign Monitor.

Press on the SAVE button to complete your Campaign Monitor integration.

To connect your Forminator Form to ActiveCampaign, click the [+] icon for ActiveCampaign.

This will bring a pop-up screen where you need to add your ActiveCampaign API credentials, as well as an identifying label for the connected account.

To get those credentials, log in to your ActiveCampaign account, go to Settings > Developer, and copy the required URL/KEY from the API Access module.

Paste those credentials into your Forminator integration window and press the Connect button. You have now created a connection to your Active Campaign account.

To connect a form to your Active Campaign account, you need only go to the Integrations tab of the specific form where you’ll see Active Campaign in the Connected Apps section of the list. Click the [+] icon to open the integration options.

In the popup that appears, you will be asked to create a name for your Integration. Enter a name and then click Next.

This will prompt you to choose a contact list you wish your form submits added to. Choose a list and press on the Next button:

Now you need to match fields, in order for your form data to populate your chosen ActiveCampaign list. Take note that only the email address field is required by ActiveCampaign and the rest are optional. Match the fields and then click Next.

This will bring up the Additional Options pop-up where you can configure additional options for your ActiveCampaign integration. Let’s go through those options and see what they do.

• Tags – Allows you to add tags to your contacts. You can insert submitted data from your Forminator fields or you can write your own custom tags.
• Double Opt-In Form – Double opt-in Form allows you to choose which ActiveCampaign form will be used when ActiveCampaign opt-in email is sent.
• Enable Instant Responders – When the instant responders option is enabled, ActiveCampaign will send any instant responders setup when the contact is added to the list. This option is not available to users on a free trial.
• Send last broadcast campaign – When the send last broadcast campaign option is enabled, ActiveCampaign will send the last campaign sent out to the list to the contact being added. This option is not available to users on a free trial.

All of these fields are completely optional and don’t need to be configured. Once done, press on the Save button. This completes your ActiveCampaign integration.

Forminator includes integration with Zapier so you can leverage all the additional integrations that service has to offer.

To enable Zapier integration in Forminator, click the [+] icon for Zapier.

Then click the Activate button to complete the initial integration.

Now to connect a form to Zapier, you need only go to the Integrations tab of the specific form where you’ll see Zapier in the Connected Apps section of the list. Click the [+] icon to open a pop-up where you need to enter your connection name and your Webhook URL:

If you haven’t created any ZAPs before, go to your Zapier account and click on the Create Zap button.

On the next screen, click the Open Editor button.

For your trigger app choose Webhook.

From the Trigger Event dropdown, select Catch hook, then click Continue.

Copy the Custom Webhook URL shown on that screen.

Then paste that URL into the Webhook URL field in your form’s Zapier integration, and click Save there.

Then, back in your zap setup at Zapier, click the Continue button on the Webhook URL screen. Then click the Test Trigger button on the next screen.

Once you get a Success message, click Continue.

The rest is up to you and your project/needs. Good luck with your Zapier integration.

To connect Forminator to HubSpot, first click the Connect button (+ icon) in the HubSpot row.

Then, choose an identifying label for the connected account, and click Authenticate to be redirected to the HubSpot authentication page.

Log in (if necessary), and select your HubSpot account. Click Choose Account to proceed, and then click Connect App on the subsequent screen.

If HubSpot authentication is successful, you will be redirected to Forminator and presented with a success message.

To connect a form to HubSpot, first open the form in Forminator and switch to the Integrations tab. Then, click the Activate button (+ icon) in the HubSpot row.

If desired, select a static HubSpot list to which contacts will be added. Otherwise, contacts will be added to HubSpot without being added to a list.

Next, map the form’s fields to fields in HubSpot by selecting from the Forminator Fields dropdown menus. Click Add Additional Field to add additional fields as needed, then click Continue.

Finally, enable the creation of HubSpot tickets for each form submission, if desired. Click Activate to activate the integration.

Once activated, contact information gleaned from each form submission will be added to HubSpot.

Consent/GDPR integration

If you are using a Consent field in your form, and need to have a corresponding entry for each contact in your Hubspot list, here’s how to configure that in your Hubspot account.

First, go to Settings > Properties in your Hubspot account, and search for the “Legal basis for processing contact’s data” property.

Click on that property to edit it. In the modal that pops open, click + Add an option at the bottom. Give your new custom option any recognizable name you want, but be sure the value you enter for it is: true. Then click Save.

Next, back on the Properties screen, you’ll want to ensure that property is assigned to the Contact Information group. Hover your mouse over that property and click the More button, then select Move to Group.

In the modal that pops open, select the Contact Information group, and click Save.

Then, to get your custom Consent/GDPR entry to show up in your list, go to Contacts > Lists and click to open the Static List you’re using for your Forminator form. Select Edit Columns from the Actions menu at top-right.

In the modal that pops open, search for the “Legal basis for processing contact’s data” property, and check the box next to it to add it to the available columns on the right. Drag & drop to move that column to your preferred position in your list and click Save at the bottom of that modal.

Now, whenever a user submits a Hubspot-connected form with a Consent field, you’ll see your custom entry in your contact list for that user.

Moving your submissions to Google Sheets, for a better preview and easier sorting is just a few clicks away, so let’s see how you can set this up. Click the [+] icon for Google Sheets.

This will bring a new popup window where you need to put in your Google Client ID and your Client Secret code, as well as an identifying label for the connected account. Click the Guide to generate credentials link to jump to the technical document (this document) for a guide to creating your credentials.

To get those, go here and create a new Project.

Name your project and then click the Create button.

Once you’ve created your project, go to APIs & Services/Dashboard.

Select your project and then click Enable APIs and Services.

Find and enable Google Drive API and Google Sheets API.

Now go back to APIs & Services, and click on OAuth consent screen. If you’re a GSuite user and want this app to be restricted to users within your organization, select the Internal option here. For all other cases, select External. Then click the Create button.

The following screen is where you’ll enter the info that appears on the consent screen when authorizing the app. As you will be the only one authorizing it for integration with Forminator, you only need to fill in the following required fields:

• App name – enter any name you like
• User support email – use the same address as the Google account you’re logged-in with
• Developer contact email – same as above

Then click +Add Domain and enter your site’s domain name in the Authorized Domains section. Note that you can only enter top-level domains here. So if your site is installed in a subdomain like sub.example.com, enter only the top-level domain: example.com

Click Save & Continue.

Ignore everything on the Scopes and Test Users screens, and simply click the Save & Continue button on each of those. Then, on the final Summary screen, click the Back to Dashboard button at the bottom.

On that next screen, click the Publish App button, then the Confirm button in the little modal that pops up.

Next, click on the Credentials tab and, in the +Create Credentials dropdown, select Oauth client ID.

On the new screen choose Web application. Then Name your Oauth ID and in the Authorized redirect URIs field, paste the URL given by the Forminator Google Sheets integration pop-up.

You’ll find the Forminator redirect URL you need to copy in the instructions section of the Google Sheets integration pop-up in your site admin.

When you click the Create button, a popup will appear where you’ll see the Client ID and the Client Secret we mentioned at the beginning.

Copy those and paste them in the corresponding fields on your site and click the Next button.

You’ll then see “Connect Google Sheets” appear in the popup; click the Authorize button there.

That will open a new tab where you’ll be prompted to log into your Google account (the same Google account you were logged into to create the above creds). In case you see an alert that the app isn’t verified, just click on Advanced and then on the site name you connected this to (“unsafe message”) and then Approve:

Click the Allow buttons in the next options of the authorization steps and, once that’s done, click the Close button in the popup in your Forminator Integration settings.

Now that the integration with Forminator is complete, let’s connect a sheet to a form. Go to your desired form, click Google Sheets integration and, in the new pop-up screen, enter a name for this connection and click Next.

On the next screen in the popup, you can optionally enter the Drive Folder ID where you’d like your Google sheet to be created and stored. The folder ID would be only the part after /#folders/ in the URL.

For example, from this folder URL – https://drive.google.com/#folders/0B6GD66ctHXdCOWZKNDRIRGJJXS3 – the Directory ID would be only 0B6GD66ctHXdCOWZKNDRIRGJJXS3

If you do not specify a Drive Folder ID here, your spreadsheet will be created in the root/home directory of your Drive.

Then enter a name for your spreadsheet in the popup and click Create.

This will create a new Google Sheet, with the chosen name, in your destination folder.

From now on, each time someone fills out this form, the created Google Sheet will also populate, enjoy!

To get started, click the [+] icon for AWeber.

In the following pop-up, choose an identifying label for the connected account and click on Authorize.

This will open a new browser tab where you need to enter your AWeber credentials in order to establish the connection between your Forminator form and your AWeber mailing list:

Once done, click the Allow Access button. You’ll be redirected back to your site where you’ll see confirmation that Aweber is successfully connected. Click the Close button to continue.

To connect a form to your AWeber account, you need only go to the Integrations tab of the specific form where you’ll see AWeber in the Connected Apps section of the list. Click the [+] icon to open the integration options.

The first step is to set up the connection name for AWeber (enter anything you like as this is only used to easily identify the connection):

Now you need to choose an AWeber list which will get populated with your chosen Forminator form data (the drop-down menu will show all the available lists from your AWeber account):

After you have chosen the list, click the Next button to match your Forminator form fields with your AWeber fields. Take note that the only required field is the Email Address and all other available fields are just optional. Once done, click Next.

The Additional Options step lets you set up your AWeber configuration to the smallest details. These are completely optional and you can just finish your integration here by pressing the Save button.

• Ad tracking – Will label subscribers based on how they signed up. You can use the pre-defined value, one of the Forminator form field data or custom values. See what is ad tracking in AWeber.
• Tags – You can also use Forminator form fields values or any custom text for your tags. In case you want to use the tag to add the subscriber to your AWeber campaign follow the guide here.

That does it! Each submitted form on your site will also trigger a confirmation email from AWeber, so your visitor can subscribe to your mailing list:

Slack is a team communication tool and stands for Searchable Log of All Conversation and Knowledge.

To begin, click the [+] icon in Forminator for Slack integration.

The Setup step is where you need to enter the Client ID and Client Secret for your Slack integration.

To get those needed credentials, you need to sign in to Slack in your browser. You can not complete the setup through the Slack app.

Once you’re signed in to your Slack workspace, go to Slack API to create a new Slack App. Fill out the App Name and choose your workspace from the Development Slack Workspace dropdown.

After you click the Create App button, scroll down the page to find the App Credentials section.

Copy and paste your Client ID and Client Secret into the corresponding fields in your Forminator Integration Setup screen.

Next copy the Redirect URL from the Forminator Setup screen. Go back to your Slack App settings and go to Features > OAuth & Permissions > Redirect URLs section.

Click the Add New Redirect URL button, enter the URL you copied from the Forminator setup step and click the Add button. Then click Save URLs.

Then go back to the Forminator and click the Next button. You will need to authorize Forminator to connect with Slack.

You will be redirected to Slack to allow your app (my app’s name is Forminator in the screenshot below) to access your Slack workspace.

You’ll receive a success message once you press the Authorize button.

Now that we’ve connected to Slack, we need tell our form where to send a notification in Slack.

Navigate to your form and go to the Integration section. Select Slack from the Integrations list and enter a name for your integration.

When someone fills out your form, Forminator will send a message to Slack. You need to decide where you would like to send that message; to a public channel, private group or DM channel so the right person will be notified.

Then you need to specify which public channel, private channel or who you would like to send a direct message to.

Then you’ll finish up by formatting the message. You can even insert the data your form collects in the Slack message with the plus icon.

When you’re finished click on the connect button. That’s it!

To get started, click the [+] icon for Trello.

That will pop open a modal window where you’ll be prompted to enter your Trello API Key, and an optional Identifier for this integration.

Visit the App Key page in your Trello account to get your API Key.

While there, be sure the URL of the site you are connecting Trello to is in the list of Allowed Origins on that same page. If it is not, add it now.

Once you’ve entered your API Key and Identifier, click Next. Then click Authorize.

A new browser tab will open, asking for your permission to connect your site with your Trello account. If you are not yet logged into your Trello account, you’ll see the login option first. Once logged in, click Allow.

You’ll then be redirected back to your site where you’ll see confirmation that Trello is successfully integrated with Forminator. Click the Close button to continue.

To connect a form to your Trello account, you need only go to the Integrations tab of the specific form where you’ll see Trello in the Connected Apps section of the list. Click the [+] icon to open the integration options.

Set up a connection name which only identifies the connection within a form.

Choose which Trello board you want the cards to be added to. If no board is found, you’ll be prompted to create one first.

After the board is chosen, choose a list to add your generated cards to.

Last but not least, you will have the option to customize the Card that will be added to your Trello board. By default you don’t have to change anything here, we already provided you with the standard template that will work out of the box, so you can just click the Save button to complete the integration. In case you do want to customize your card, let’s see what each field does.

• Card name – This value will be used as the title on the created card. Other form data can also be added by clicking on the “+”
• Card description – This value will be used as a description of the created card. By default it will use a special placeholder {all_fields} which will display all the submitted data of your form. Other form data can also be added by clicking on the [+] icon. On top of that, you can add Trello flavored markdown.
• Position – The position will be used to determine the placement of a new card. By default, it will be added on the bottom of your chosen list, but you can also choose to add it on top of the previous cards.
• Due Date – Use the date-picker feature to select a due date.
• Card Position – The position will be used to determine the placement of a new card. By default, it will be added on the bottom of your chosen list, but you can also choose to add it on top of the previous cards.
• Labels – Labels can be added to the card if you specify it and you can add multiple ones.
• Members – Each card can be assigned to a specific member of your Trello board, so add as many members as you wish there.

Connect Forminator to your custom built apps using our full featured API.

CleanTalk has included support for Forminator forms, making it just too easy to protect your forms from spam submissions.

To get started, install CleanTalk on your site. You can install either via Plugins > Add New in your site admin, or download it from wordpress.org here.

Once installed and activated, go to Settings > Anti-Spam by CleanTalk, and click the Get Access Key Automatically button at the top. That will create a free account for you at CleanTalk.

You’ll then see that the buttons at the top have changed. Click on the one that says Click here to get anti-spam statistics to go to your new account at CleanTalk where you can view and manage any form spam it catches.

As this is a new install, you won’t see any data there yet. But you can test the integration by submitting your Forminator form with this test email address that will be automatically added to your blocklist there: [email protected]

Note that, by default, users with the Administrator role are exempted from the spam protection in this plugin. So you’d want to either test with a different role, or test in a different browser. You can also disable protection of the Administrator role if you wish by clicking on the Advanced Settings link in the plugin settings, then scroll down to Roles which bypass spam test and de-select the role.

To customize or edit the list of blocked email addresses or domains in your CleanTalk account, click the Personal Lists link under your domain name.

As this is a free account automatically created for you by the plugin, you’ll be prompted to login with your username & password. That will have been sent to you automatically at the admin email address you have set in your site’s Settings. Check that email for the needed password.

Once logged in, you’ll see all the data for any blocked spam submissions. You can customize the criteria for spam blocking by adding filters to your list. Click the Add new filter button to get started.

See CleanTalk’s blacklist documentation for more information on customizing your lists.

Forminator integrates with the E2Pdf plugin which enables you to easily create PDF documents from your form submissions. Check out the video walkthrough below, or follow the written directions to set up your integration.

To get started, install either the free or pro version of E2Pdf. You can install the free version either via Plugins > Add New in your site admin, or download it from wordpress.org here.

Once installed and activated, click on the E2Pdf menu item in your admin menu. Then go to Settings > Extensions in that plugin’s options panel, and ensure that the Forminator option is not disabled.

Creating your PDF

To create a PDF for submissions from a Forminator form, go to E2Pdf > Templates, and click the Add New button.

In the modal that pops up, select Forminator from the available options in the Extension dropdown. Then from the Item options, select the form you want to use to create your PDF. Adjust other formatting options however you like in that popup; you can always edit them later.

Now you want to decide whether you want to create your PDF from scratch using only selected form elements, or if you want the plugin to create one automatically for you using all available elements from your selected form.

• Empty PDF – Click that button to create a blank canvas so you can add only the form elements you want.
• Auto PDF – Click that button to automatically add all available form elements to the canvas, and you can edit as needed.

Once you click either button, the popup will close, and you’ll have your PDF canvas all set up and ready to be customized.

If you had selected the Empty PDF option, or want to add more fields to an existing template (like an e-signature field, which does not import automatically), simply drag and drop them from the PDF Builder metabox on the right.

Double-click on any element in the canvas to edit its content, resize or move it. Right-click on any element to reveal additional options where you can map the PDF field to any other form field if needed.

There are numerous other formatting options in this plugin which we won’t get into here. If you need more info on available options and how to use them, check out the extensive documentation & FAQs on the E2Pdf website.

Integrating the PDF with your form features

To get your new PDF integrated with your form, there are a few shortcodes you can use depending on what you need. Once you have saved your PDF template, you’ll find all the available shortcodes for it in the metabox at the top-right of the E2Pdf Templates screen.

Click that Shortcodes button to reveal all shortcodes for your PDF. The ones we are most interested in for this integration are the attachment, download and view shortcodes. For example:

• [e2pdf-view id="1"] – Embeds the PDF wherever you want to display it.
• [e2pdf-attachment id="1"] – Creates an email attachment.
• [e2pdf-download id="1"] – Creates a simple download link you can embed anywhere, even in emails.

View Shortcode

The “view” shortcode can be included in the After submission Inline Message that can be displayed on your form page once the user submits the form. You’d probably want to disable the Auto-close option so the message and PDF remain on-screen.

The PDF displayed in the success message could look like this example marathon calculator form:

Attachment Shortcode

The “attachment” shortcode can be included in the email notification sent to the user who submits the form so they can view or download your PDF directly from the email.

That would generate a familiar PDF attachment in the email sent to the user:

Download Shortcode

The “download” shortcode simply creates a PDF download link. It can be useful as well to include in the success message that displays after the user submits the form, or in the email notification sent to the admin or user, or anywhere else you might want to include it. The link would look like the examples below:

An addon plugin is available for the excellent wpDataTables plugin that enables you to create frontend tables, graphs and charts from your Forminator form, quiz and poll submissions: wpDataTables integration for Forminator Forms.

To get started, install the wpDataTables integration for Forminator Forms plugin on your site. You can install either via Plugins > Add New in your site admin, or download it from wordpress.org here.

Once installed and activated, go to wpDataTables > Create a Table, select the Create a data table linked to an existing data source option, and click Next.

On the next screen, give your new table a Name; you can always edit this later.

Then, for the Input data source type option, select Forminator Form.

For the Choose a Forminator Form option, select the form, poll or quiz you want to use for your new table.

Note that the form, poll or quiz you want to use must have at least one submission stored in your database or you won’t be able to create a table with it, and will see an error like this if you try.

Once you’ve selected the form, poll or quiz you want, the Choose fields to show as columns option will be populated with all the fields that can be used in your table. Note that fields like CAPTCHA, HTML, Page break, Section, and Consent are not used in tables and are excluded.

Click that option to pop it open to view and select the fields you want included in your table. Click Select All or click on individual fields to highlight only the ones you want.

One you’ve selected all the fields you want to include in your table, click Save Changes at the top-right of the screen.

You’ll then see several new options & settings to explore along the top of the screen. Some of these options are only available in the Pro version of the wpDataTables plugin though.

• Data source – The screen you’re currently on and where you can change the source and/or included fields if needed.
• Display – Options to fine-tune the layout of your table for the frontend display.
• Sorting and filtering – Options to allow your users to filter and sort the data in your frontend table display.
• Table Tools – Enable copy & save options in your table like print, PDF, CSV, etc.
• Placeholders – (Pro only) Options here cannot be used with tables generated from Forminator data.
• Customize – (Pro only) Table styling options.
• Forminator Settings – Options to filter the Forminator data displayed in your table by ID or date range.

Once you’re happy with how you have your table set up, copy the shortcode from the top of the screen and add it to a page on your site to see how it looks and works.

You’ll likely want to come back to the settings to adjust things. There are way too many options in the wpDataTables plugin to go over here, which is outside the scope of this usage document.

For help with configuration of its many features, click a View Documentation link anywhere in that plugin to consult the extensive wpDataTables documentation.

Here are a few examples of the types of frontend tables & charts you can create from your form, poll & quiz data.

Data from a t-shirt order form:

Data from a frontend post form:

Graph of cumulative sales data:

Chart of data from a closed poll:

Clearout enables you to automatically filter out undesirable and invalid email addresses from your form submissions, and consequently from your email lists, ensuring only high-quality leads.

They provide 2 methods that you can use to integrate with your Forminator forms:

• A plugin method to apply the validation to all your forms
• A javascript method that you can apply to specific forms only

Note that you can customize the message that appears when an email address does not validate under the Email Settings tab of your Email field.

Plugin Method

To get started using the plugin method for all your forms, first install the Clearout Email Validation plugin on your site. You can install either via Plugins > Add New in your site admin, or download it from wordpress.org here.

Next, log into your Clearout account, or create one now if you haven’t already.

Once logged-in, go to the Apps tab and click the + Create App button.

In the modal window that pops open, select the Server option. Then give your app a Name and an optional Description, and click Create.

Finally, click the copy icon next to your new app to copy your app API Token.

Now go back to your site, navigate to Settings > Clearout Email Validator in your site admin, and paste the Clearout API token in the field provided.

Then scroll down to the Apply Validation section of the plugin settings where you’ll see a list of compatible plugins. Clearout has stated that a native integration with Forminator is coming soon, but for now, you’ll want to check the is_email box next to the Select Hooks option. Then click the Apply button to complete this integration.

This integration will now affect all Forminator forms on your site.

Javascript Method

To use the javascript method for specific forms, first log into your Clearout account, or create one now if you haven’t already.

Once logged-in, go to the Apps tab and click the + Create App button.

In the modal window that pops open, select the Client (JavaScript Widget) option. Then give your app a Name and an optional Description. Customize any of the other options if you wish, then click Create.

Finally, click the copy icon next to your new app to copy your app’s JS code.

Now go back to your site and, on the page where you have embedded your Forminator form, add a code block in the Gutenberg editor. Paste your Clearout app’s JS code in the block, then click the Update button for your page.

This integration will now affect only this particular form on your site.

Complianz integrates with Forminator out of the box when configuring that plugin.

The Complianz Cookie Consent plugin does not have any settings specific to Forminator. However, when configuring that plugin, you may come across some options that may impact your Forminator forms.

For example, Complianz has a setting to hide Google reCAPTCHA if the corresponding cookie option is not accepted by a site visitor. So if you’re using reCAPTCHA in your forms, you’ll want to be aware of that.

Groundhogg Marketing Automation & CRM has created an integration plugin that enables you to add any contact info submitted through a Forminator form to your marketing funnels.

To get started with this integration, we’ll assume you already have the Groundhogg plugin installed and configured on your site.

Whether you have a paid Groundhogg plan or have purchased just the Forminator Integration plugin, you’ll find it in the All Access Downloads area in your Groundhogg account.

Download the integration plugin, then upload the zip file to your site via Plugins > Add New > Upload.

Once the integration plugin is installed and activated, go to Groundhogg > Funnels in your site’s wp-admin.

Once there, you can either create a new funnel or edit an existing one to include integration with any Forminator form. For the purposes of this document, we’ll create a simple new funnel.

Click the Add New button, then click the Start Building button in the Start From Scratch option.

On the next screen, click the + Add Step button and, in the modal window that pops open, select Forminator under the Benchmarks tab.

Next, select the form you wish to use for this integration, and click the Map Fields button.

In the modal window that pops open, you’ll see all the fields from your Forminator form listed in the 2 columns on the left, which you can map to any Groundhogg field you need by selecting it in the corresponding dropdown on the right.

Once you have mapped all your form fields, click the Save Changes button at the bottom of the modal.

Finally, set your funnel to Active and click the Save button.

You’ll then see the form field information you mapped appear in the Groundhogg Contacts section whenever a user fills in your selected Forminator form.

Any other steps you wish to add to your Groundhogg funnel are beyond the scope of this document. For help with that and any other issues with Groundhogg configuration, please see their support documentation.

Here you can adjust the number of forms, quizzes, and polls that display on the dashboard, configure your default email header and address, and choose how many items appear on the modules and submissions pages.

Dashboard

In the field provided, enter the number of forms, quizzes, and polls you wish to see on the dashboard, and select whether to display only published forms, only drafts, or both.

From Headers

In the Sender email address field, enter the default email address from which emails will be sent, and below that, the name you want to appear as the sender.

Pagination

Enter the number of forms, quizzes and polls to display on the main page for each, and do the same for the submissions listing page as well.

Form editor

Choose whether you want the settings modal to open automatically whenever you insert a field. This only applies when you insert one field at a time.

Click Enable High Contrast Mode to increase the visibility and accessibility of Forminator elements and components to meet WCAG AAA requirements. When enabled, High Contrast Mode only affects elements within the Forminator UI.

This section enables you to create and edit your own custom styles that can then be applied to any form with a single click.

The first time you access this section, you’ll see only the Default Preset style, which is the style that is applied to all your new forms by default. You can edit this default style, or create your own custom styles.

Creating a New Preset

To create a new custom preset, click the + New Preset button.

In the modal window that pops open, give your new custom preset a Name.

If you already have a form styled the way you want, and would like to use that style for your new custom preset, you can optionally import its appearance settings. Simply select the form you want to use from the Import dropdown.

Then click the Create Preset button and your custom preset will load on the page so you can customize everything you need.

Editing a Preset

To edit an existing preset style, either the default or one of your own custom presets, select it from the Preset dropdown.

Customizing the Preset Appearance

The specific styling options for your presets are identical to those available in each form as seen in the Appearance (Forms) chapter above, so please review that chapter for details on their use.

Note that there is no preview option for appearance presets. So if you do want to preview your styling as you go, we suggest styling the appearance of an existing form, and using the Preview option there. Then save your form, come back here and import that form’s appearance settings when creating a new custom preset.

Uninstallation

Select whether to Preserve or Reset settings and data when the plugin is uninstalled.

Reset Plugin

Need to start over with a fresh install? Click the Reset button to return Forminator to its default state.

Remember to click Save Changes after adjusting Forminator data settings.

Add an additional layer of protection to your forms with a CAPTCHA field. Forminator includes support for the following captcha types:

• Google reCAPTCHA
• hCAPTCHA

The language for each captcha type will display in your site’s language by default. But you can specify the language that should be used in the captcha at the bottom of this screen if you prefer to change it.

Google reCAPTCHA

Forminator supports three versions of Google reCAPTCHA: v2 Checkbox, v2 Invisible and v3. You must enter correct credentials for the version(s) you intend to use in your forms or you will get an error when you try to save settings in the captcha field added to your forms.

We recommend setting up all 3 versions here now so you can select to use any reCAPTCHA version in any form with no errors.

To get Google reCAPTCHA set up, go here and follow the steps below for each version you want to set up:

1. Add a Label, such as Forminator Form.
2. For reCAPTCHA type, select the version you wish to use.
3. For Domains, enter your site domain where the form is located.
4. Accept the Terms of Service.
5. Click the Submit button.

In the next step, copy your Site Key and your Secret Key and paste them into the corresponding fields on your site for the version you set up.

Once you’ve added your keys , click the Save Settings button, and you’re done. You can now add a reCAPTCHA field to any of your forms.

Note that if you set up the reCAPTCHA incorrectly here, you’ll see an error message in the preview section informing you what went wrong so you can fix the setup.

hCaptcha

Forminator supports hCaptcha as an easy alternative. You only need to enter one set of keys here and can then select either the standard or invisible captcha when adding the field to your form. See Captcha Field for details.

Note that if you’re using both Google reCAPTCHA and hCaptcha on your site, you may want to toggle on the Enable reCAPTCHA compatibility mode option here to prevent any issues.

To get hCaptcha set up, go here and click the New Site button.

Enter your site domain where the form is located in the Hostnames field, and click the Save button at the top.

In the next step, click the Settings button next to the site you just saved.

Copy your Site Key and paste it into the corresponding field in Forminator on your site.

Then, under the Settings tab, copy your Secret Key and paste it into the corresponding field in Forminator.

Once done adding your keys , click the Save Settings button, and you’re done. You can now add a hCaptcha field to any of your forms.

Note that if you set up the hCaptcha incorrectly here, you’ll see an error message in the preview section informing you what went wrong so you can fix the setup.

Forms created using the Contact From 7 plugin can be imported to Forminator, as long as the form files exist on the same site.

Click All to import all Contact Form 7 forms, or click Specific Forms to see a list of available forms from which to choose.Then, click Begin Import to proceed.

Most field Contact Form 7 field types will work just fine in Forminator, but a small number will not. These include:

• Quiz Field – Forminator doesn’t have a built-in quiz field, however, you can enable Google’s reCAPTCHA v3 and Honeypot protection on your imported forms.
• ConstantContact – Forminator doesn’t integrate directly with ConstantContact. However, you can use Zapier integration to send your leads to ConstantContact.
• reCaptcha v3 – At this stage, Forminator can’t import your existing reCAPTCHA integration. You can set this up manually on your imported forms once they are transferred.
• Additional Settings – Forminator doesn’t support CF7’s additional form settings.
• Custom field IDs – Forminator creates a unique ID for each field, and the conditional logic relies on them. However, you can provide a custom CSS class for each field.

Forms Privacy

Submissions Retention

By default, all submissions will be kept forever but you can auto erase all submissions after a certain period in case you need to set that up.

IP Retention

Forminator will save IP addresses in your database. If you need to release this data (due to GDPR or any local law) you can customize the IP retention policy here.

Account Erasure Requests

Here you can choose what will happen to the submissions of a user you are deleting from your site (by using Tools/Erase personal data) if those submissions contain an email address. Retain Submission will leave all submissions of that user intact and Remove Submission will remove all submission from the user you deleted from your site.

Poll Privacy

Submissions Retention

Much like with forms above, you can choose to auto erase all poll submissions after a certain period.

IP Retention

Each time your visitors vote, Forminator will save their IP in your database (this is used to prevent multiple votes by one visitor on the poll they already voted in and to modify vote limitations). In case you need to release this data (due to GDPR or any local law) you can enable the IP Retention here.

Quiz Privacy

Submissions Retention

Here again, just like with forms and polls above, you can choose to auto erase all quiz submissions after a certain period.

Forminator supports both Stripe and PayPal online payment processing platforms.

Connect to Stripe

To connect your Stripe account to Forminator, click the Connect to Stripe button.

You’ll be prompted to enter your Test and Live API keys in the modal that pops open.

To get the needed keys, click the here link in the feature description at the top. That link will redirect you to the API Keys page in your Stripe account once you log in if you’re not already.

Copy the Live publishable and secret keys from your Stripe account, and paste them in the corresponding fields in the Forminator popup.

You’ll then need to get the Test publishable and secret keys as well; Forminator requires both sets. To get the Test keys, click the View Test Data link near the bottom of the left sidebar in your Stripe account. Then copy the same keys from the same place on that page.

Be sure to paste the Live keys in the Live fields, and the Test keys in the Test fields, then click the Connect button. Once connected, you’ll see your Stripe connection info appear to confirm, and you can set your Default Currency for Stripe payments.

Once this setup is completed, you can add the Stripe payment field to any of your forms.

Connect to PayPal

The setup for PayPal payments is very similar to Stripe above. Start by clicking the Connect to PayPal button.

You’ll be prompted to enter your Sandbox and Live keys in the modal that pops open.

To get the needed keys, click the here link in the feature description at the top. That link will redirect you to the My apps & credentials page in your PayPal developers account. If you are not already logged in there, you’ll be prompted to do so; just log in with your regular PayPal credentials. You should then see one or two default Sandbox accounts provided by PayPal.

Click on the name of a Sandbox account to open the credentials page, then copy the Sandbox Client ID and Secret from your PayPal account, and paste them in the corresponding fields in the Forminator popup.

You’ll then need to get the Live Client ID and Secret as well; Forminator requires both sets. To get the Live keys, to the My apps & credentials page in your PayPal developers account. Then click the Live toggle at the top, and click the Create app button to create a live REST API app if you haven’t already.

Get the live Client ID and Secret keys the same way as the sandbox ones: click the name of your app and copy them from the next page. Then paste those keys in the corresponding fields in the Forminator popup.

Once again, be sure to paste the Live keys in the Live fields, and the Sandbox keys in the Sandbox fields, then click the Connect button. Once connected, you’ll see your PayPal connection info appear to confirm, and you can set your Default Currency for PayPal payments.

Once this setup is completed, you can add the PayPal payment field to any of your forms.

The user roles feature allows you to manage your users’ ability to configure Forminator by offering a manage_forminator capability. This means that you can give certain users access to all of the behind-the-scenes Forminator settings without needing to grant them full admin access to your site.

Firstly, you will need to install and activate a user role editor plugin to be able to customize these user capabilities. We recommend using User Role Editor but it is really up to your own preference.

If you are using User Role Editor, navigate to Users>User Role Editor from your admin dashboard.

Under all of your available capabilities, you should see manage_forminator. This is the capability that you can either add to existing roles or create a new role around – which will give users with that role full access to manage Forminator. If you are new to User Role Editor and would like some more guidance on how to navigate through the plugin, you can check out the official documentation here.

Note that it is possible that the manage_forminator capability does not immediately appear in the list. In that case, you can add it by clicking the “Add Capability” button on the far-right of the User Role Editor plugin interface. Then, in the little modal that pops open, add it and click the “Add Capability” button there to confirm that action.

Once you have set up a role that includes the manage_forminator capability, you can simply apply that role to your desired users as per usual. In the example below, a user role called Forminator Access was created which included the manage_forminator capability.