This is the documentation for Evolution Forms.


  • Tested up to Worpdress


Using Wordpress

  1. Go to Plugins → Add new
  2. Click Upload Plugin (at the top)
  3. Browse for mwitd-evfo*.zip
  4. Click Install Now


  1. Unpack mwitd-evfo*.zip
  2. Upload the mwitd-forms2 folder to wp-content/plugins/
  3. In Wordpress, go to Plugins and look for Evolution Forms, click on Activate

After Evolution forms has been installed and activated, its license needs to be activated in order to unlock all features. This is described in detail in the following step.

License Activation

With the purchase of Evolution Forms, you obtain a license key which is needed to unlock all features of the plugin.

The license key is displayed right after the purchase and in the confirmation email. You can also log in with your email address here and see all of your license keys: User Area - Evolution Forms

The license key can be entered in the Wordpress admin dashboard.

Wordpress menu entry

After successfully activating Evolution Forms, all features will be unlocked.

Should you experience and problems with the activation process, don't hesitate to contact us: Support - Evolution Forms

Form list

In the overview forms can be created, imported, export and removed.

Create new Form

This button opens the editor with an empty form.


Forms can be embedded on pages using this code. Copy and paste it into any page you would like the form to appear. Multiple forms per page are supported.


Date the form was last changed.



Opens the form in the editor.


Downloads the form as a file. This can be used as a backup or to transfer the form to a different website.


Creates a copy of the form.


Removes a form from the list. Answers to removed forms can still be viewed.

Form Editor

New forms can be created in the Wordpress admin menu: Evolution FormsAdd new.

Already created forms can be found in the forms overview by clicking on Evolution Forms in the sidebar.

Form Title

The form title is displayed above the form by default. It can be hidden in the form settings. The form title also appears in the confirmation mails for users.

Edit Form

You will find three tabs at the top of the editor page: Edit Form, Edit Design and Edit Settings.

An empty form is created with two steps. Existing steps can be found in the left sidebar of the editor.

New steps can be added with the Add Step button. Clicking this button opens a window that lets you choose from all available form element types which are explained here.

End ("Thank you" page)

Please note that this step is always shown after the user submits the form data. You can use this page to thank the user for their participation. You can also leave this page empty in case a redirection is set up in the form settings.


The Save can be found in the top right and bottom right of the editor.

Form Elements

General Element Settings

Some settings apply to all elements:

Hide Title

Hides the title of the form element. A title should be entered even if the title is hidden since it will still appear in the lead view.


Expects the user to fill out this element. A notification will be shown if the user tries to proceed without filling out the element.


Element: Text

This element displays any content.

Element: Heading

This element displays a heading over the current form step. Its position in the editor does not matter, it will always be shown at the top.


Element: Selection

The selection element can be used to ask for a choice of multiple options.

Automatically advance to the next step on selection: When this is enabled, the form will automatically advance to the next step when an option is selected.

Allow selection of multiple options: When this is enabled, multiple options can be selected instead of just one.


Lets you select in how many columns the options are displayed.

Default uses as many columns as possible. The other options restrict the amount of options per row.


New options can be added with the Add New Option button.

An option can be represented by plain text (next to a checkbox or radio button) or by an image.

To use an image, select the Use Image option. You can then select an image from your WordPress library.

Alternatively, select Use Icon to select an icon from the FontAwesome library.

You can optionally also hide the option's title if the image or icon is enough. For this, activate the "Hide Title" option.

Element: Checkbox

This element displays a single checkbox which can be used to ask for consent (e.g. over terms of services).

Element: Privacy Policy Checkbox

This element displays a single checkbox which can be used to ask for consent (e.g. over terms of services).

The text can be freely edited. *link* will be replaced by the link text set below. The destination page can also be set, e.g. to the privacy policy page or the terms of service.

Element: Text Input

An element for simple text input.

Element: Text Area

An element for multi-line text input.

Element: File Upload

This element allows visitors to upload files. The element can be configured to accept multiple files and certain file types.

Element: Honeypot

This element can be used to counter spam bots. This element is invisible and could technically only be filled out by bots. Give it a generic title like "Name" or "Email". The form will not advance to the next step if this element has been filled out. Users will not be able to see or interact with this element.

Element: Range

This element lets users enter a number using the range slider. Minimum, maximum, step size and the initial value can be set. There is also an option for a symbol to be displayed next to the selected number.


Element: Email

Similar to Text Input. The input will be checked if it resembles an email address.

Other Address Elements

These elements are regular text inputs. However, they are saved with an identifier so forms submissions can be filtered for name, street, zip code, city, phone, etc.



The Design settings allow you to set the form's appearance.


Main Color

The main color defines the accent color of the form. This includes the buttons, frame and loading symbol. This color can be overwritten by the options further below.

Background Color

The background color defines the background of the form. This color can be set to anything you like. The font color will be adjusted automatically so it can be read easily (e.g. the font color is white on dark backgrounds and black on bright backgrounds).

Font Color (overwrite automatic color)

Enable this option to overwrite the automatically set font color. This applies to all text in the form, excluding text on buttons.


Button Color

Enable this option to overwrite the default color for buttons. The font color will be adjusted automatically, unless overwritten by the font color option below.

Font Color on Buttons

Enable this option to overwrite the automatically set font color for buttons.


Frame Color

Enable this option to overwrite the main color for the form's frame.


Raise plugin

Some setups might require the form to be further in the foreground if it is hidden by other elements on the website. Enable this option to raise it further towards the top.


Globale Einstellungen überschreiben

Gibt die Einstellungen für das Formular frei. Ansonsten gelten die globalen Einstellungen.


Form Title

Hide Form Title

Hides the form title which is usually displayed at the top of the form.

Navigation Buttons

Hide Previous / Next Buttons

Hides the navigation buttons on all form steps. Only use this if you have Selection elements set up with "Automatically advance to the next step on selection".

Disable back button

Disables the Back navigation button so that changes cannot be made to previous steps.

Progress Bar

Hide Progress Bar

Hides the progress bar which is usually displayed at the top of the form.


Email address for notifications

A notification email is sent to this address whenever a form has been filled out.

Name of sender

"From" name to use when a form is configured to send a notification email to the visitor

Confirmation Email Message

Message for the email that gets sent out whenever a visitor completes a form. (Text or HTML)

Confirmation Email Footer

Content of the email's footer. This can be used for contact information or links.

Data Removal Page

Page to be used for user data removal requests. This is the page that will open when users click on the data removal request link in the confirmation mail. Any empty page will do: Evolution Forms will fill it automatically.


Redirect after Submission

Whether the visitor should be redirected to a different URL when they clicked on "Submit".

Reditrection Target

URL to redirect to in case the option above is selected.


Forms can be embedded in any page by using the evfo shortcode.

A shortcode looks like this:

[evfo id="1" form-location="second form on home page"]

You can find a form's shortcode under Evolution Forms in the form list. You can click to select it, then use CTRL + C or right click → Copy.

The shortcode uses two parameters:

id determines which form to load.

form-location is a description that you can set. This is useful if you use the same form in different locations, for example one at the top and the other one at the bottom of the page. This way you can find out where on the site the users filled out your form.


All form responses (leads) can be found under Evolution FormsLeads in the WordPress admin dashboard.


The overview provides a list of all created forms. The following statistics can also be read from it:

Completed Runs: The number of complete form submissions.

The list of runs can be opened by clicking on any of the links in the list.


The overview of a form's responses provides information about the time of completion and the email address of the person who submitted the information (if the form contains an email element).

Run: This is either the email address of the sender if the form does not contain an email element.

Date: The date when the form was submitted

Completed: Shows whether the submission is complete.


Remove: Removes data of this response. This cannot be undone.


The overview of a single form response shows all form answers that were submitted.

Completed: Date when the data was submitted

Duration: The time needed to fill out the form


In the logs overview you can find a list of actions and when they were performed:

  • Form removals

  • Sent notifications

  • Data removal requests




Evolution Forms uses the REST API WordPress provides and defines two routes to retrieve form data and form response data (leads). In order to use the API, the extension has to be purchased from the Extensions menu.

Base URL

In order for the API to work, the permalink setting in WordPress needs to be set to Post name (/wp-admin/options-permalink.php on your WordPress instance). HTTPS needs to be enabled.

Evolution Forms provides

Here's an example for a complete URL:


The API uses application passwords which have to be generated in the WordPress user settings.

Test Authentication

You can test your credentials with cURL:


Replace USERNAME and APPLICATION_PASSWORD with your credentials.



Information about available forms


formIDs (Array of integers): Which forms to query for. Leave empty to retrieve all forms. Can also be specified in the route: /wp-json/evolution-forms/v1/forms/23


Form responses (leads)


formIDs (array of integers): Which forms to query for. Leave empty to retrieve responses to all forms.

responseIDs (array of strings): Which specific responses to pick.

page (integer: Number of page. Leave empty to retrieve all responses at once.

detailed (boolean): Merges all steps from the steps array so that all element responses are in one large array called elements. Also adds stepID, dateStart and dateEnd to element responses.


Responses to forms 22 and 33:[0]=22&formIDs[1]=33

Response with ID htUpIvGeNFadxpYk3jCPxXPXm:[0]=htUpIvGeNFadxpYk3jCPxXPXm


Version numbers represent the publication date.

E.g. version 20.1207 was published on the 7th of December, 2020.


  • test


  • Option to prefill elements
  • Updates for Evolution Forms Statistics


  • New Element: Calendly embed
  • Editor optimized for faster loading
  • Backend
    • Added "Show Leads" link to the form overview
    • Added "Edit Form" link to the form lead overview


  • Frontend
    • Fixed: Selection element auto-advance sometimes loaded steps twice
  • Editor:
    • Elements and conditions are now verified before saving to make sure that all required values are set
    • Empty titles are highlighted in red
    • Fixed: In some cases the order of form steps was not displayed correctly
    • "Required" option removed from range element since it had no effect
    • Editor reloads with the lowest unused ID when no form ID is provided


  • Fixed: Error when refreshing database
  • Fixed: Checkbox for privacy policy was not verified


  • Extensions can now be installed via WP Admin (Evolution Forms → Extensions)
  • Fixed: Tooltip symbols were misaligned


  • Added Support for Evolution Forms Statistics


  • Fixed: Inconsistent behavior of conditinos when going back
  • Fixed: Selection option layout in Chromium browsers
  • Fixed: Disabled redirection in editor preview


  • Editor:
    • Fixed: Hiding the element title did not work for some elements.
    • Text input elements now use a regular input element when "Display title as placeholder" is enabled since HTML is not supported in placeholder texts
    • Only one heading element can be added per step. Multiple headings can still be added using one heading element and line breaks between individual headings.


  • Fixed: Selection options did not fill the entire width in mobile layout
  • Fixed: Radio buttons were clipped in mobile layout
  • The link of the privacy policy checkbox is now bold.


  • Fixed: File upload did not work correctly


  • Editor
    • Fixed: Duplication of form steps did not work as intended. Important: Clear your cache first. Existing forms need to be edited and saved again. Some options have to be set (e.g. "show icon" for selection options). After that all settings should stick and existing forms should continue working as intended.


  • Editor
    • Fixed: Next/back buttons were not centered in the preview
  • Frontend
    • Displays an error if the embedded form could not be found.
  • Backend
    • Tweaked the header layout to be closer to the WordPress style
    • Paging for forms, leads and the log
    • Added Evolution Forms logo to the sidebar entry
  • Translation for en_GB


  • Editor
    • Fixed: Closing the image gallery did not work
    • Fixed: Height of element title editor was unlimited, making it invisible if the screen height was too low
    • Duplicate steps
    • Moved step action buttons further to the top
  • New element: Checkbox für Datenschutzerklärung
  • Backend
    • Zähler für ungelesene Leads


  • Frontend
    • Fixes for theme compatibility


  • Frontend
    • Fixed: column layouts for selection elements were not centered
    • Tooltips now use a more consistent design and use the colors specified in the settings
  • Backend
    • The font color can now be set in the following ways:
      • automatically
      • by theme
      • custom
    • More hints for


  • Backend
    • Improvements for the overview page: Shows recently edited forms and number of views (impressions)
    • A table layout is now used for the single lead view
    • Automatically copy form shortcode on click
    • Merge admin sub-pages into Settings page
  • Internal
    • Change date format to UNIX epoch


  • Editor
    • Preview for form steps
  • Backend
    • Statistical overview on main plugin page


  • Form frontend

    • Option to hide background and frame of forms
    • Handle error if form can not be found
  • Internal

    • Improve settings structure
  • Editor

    • Form settings can now be selectively overwrite the global settings

    • Style improvements

    • Made icon selection easier


  • Clear cache for various WordPress plugins after upgrade to ensure that the latest version of Evolution Form is loaded for visitors
    • WP Fastest Cache
    • W3 Total Cache
    • WP-Optimize
    • WP Rocket
    • WP Super Cache
    • Cache Enabler
  • Added support for locales de, de_DE_formal, de_AT, de_CH, de_CH_informal


  • Allow setting custom font families in Form elements (depending on the styles available to the WordPress Editor)
  • Don't use email subject if left empty


  • Export Leads as CSV

    • Single and multiple leads can now be exported as CSV
  • Range Element

    • Add option for singular form of unit (shown when 1 is selected)
  • Spacer Element

    • New Element to add space between other elements
  • Form Frontend

    • Fix beahavior of back button
    • Fix visibility of some icons
  • Leads

    • Export or remove multiple form responses at once: Select some or all responses and perform actions on them.
  • Form List

    • Remove multiple forms at once


  • Upload Element

    • added option for maximum number of files
    • fix error when mime types are not set
  • Notifications and Confirmation Emails

    • TinyMCE (wp_edit) is now used for editing email body and footer
    • new field for confirmation sender email
    • new field for confirmation sender name
    • new field for confirmation subject


  • Conditions

    • update style for conditions so that the operator (and/or) is displayed between the conditions
    • added German help link
  • Confirmation emails

    • added options in settings: sending submission data to visitors/admins is now optional
  • updated translation


  • Checkbox element

    • improve design

    • fix verification

  • Upload element

    • display detailed upload errors for each file

    • display allowed file types

    • several security improvements


  • New Elements
    • Checkbox
    • Company
  • Upload Element
    • select from a list of all supported file types
    • more secure mime type check
    • users who uploaded a file and leave the page are prompted with a message
  • improved translation
  • improved editor design


  • first public version