Craft CMS Plugins

Freeform Freeform 1.2.0

A powerful form building plugin that gives you full control to create simple or complex forms.

Composer interface Composer interface - drag and drop Composer interface - mailing lists Composer interface - multipage Forms list Submissions list Edit submissions Create email notifications General settings Connect mailing list API integration Demo template - form with errors Demo template - multi-page form

  Plugin Overview

Freeform is the most powerful form building plugin for Craft on the market. It gives you full control to create simple or complex forms.

Freeform centers itself around the idea of letting admins and/or clients enjoy the experience of building and managing simple or complex forms in an intuitive interface that lets you see a live preview of the forms you’re building. We call this Composer, where almost everything is at your fingertips as it aims to stay out of your way and let you do as much as possible without having to move around to other areas in the control panel. At the same time, Freeform is very powerful and flexible, so there is also a wide variety of other features, settings and options.

Freeform uses its own set of fields and field types. Fields are global and available to all forms, but they can also be overwritten per form. This allows you to save time reusing existing fields when making other forms, but also gives you flexibility to make adjustments to them when needed. So to clarify, you can create fields with labels and options that are common to all forms, but also override those on each form.

Email notifications are global and can be reused for multiple forms, saving you time when you are managing many forms. Freeform allows you to send email notifications upon submittal of a form 4 different ways, each with their own content/template.

Freeform attempts to do all the heavy lifting when it comes to templating. Our looping templating approach allows you to automate all or almost all of your form formatting.

Freeform also allows for true multi-page forms, has its own built in spam protection service, and is capable of supporting several popular Mailing List and CRM (Customer Relationship Management) API integrations, including MailChimp (included with Freeform), Constant Contact, Campaign Monitor, Salesforce and HubSpot.

Last but not least, included with Freeform is a set of Demo Templates that can be installed on your site, instantaneously giving you a real-world set of styled, working templates.

  Key Features

Intuitive Layout Editor

Like no other, lets you build forms effortlessly

Multi-Column Layouts

Drag and drop fields wherever you want them

Live Preview

Customize away and watch Composer keep up with you

Everything at Your Fingertips

Composer interface lets you do just about everything

Multi-Page Forms

Only form building solution to support multi-page forms

Global Set of Fields

Reuse them over and over, and customize per form

HTML Blocks

Place blocks of HTML wherever and whenever

Store Submission Data, or Not

Choose to store submission data, or never keep it on your site

Twig Template Formatting

Full control with regular Twig templates to customize layouts

Automated Templating

Loop through pages, rows and fields to automate rendering

Inline Errors

Display error messages and validation per field upon submit

Submission Data on Front End

Display lists of submissions and/or each submission's data individually inside your templates

Flexible Email Notifications

Almost every conceivable option for sending HTML email(s), all customizable

Built in Spam Protection

Powerful and effective advanced spam control built right in

Mailing List API Integrations

MailChimp included, with other popular options available

CRM API Integrations

Some popular CRM options available

Manage Submissions

View, edit, delete or export form submissions

Custom Statuses

Add however many statuses you need

User Group Permissions

Granular user group and user permission controls


Relate/attach a form to any other element type


Translate fields for front end with translation files

Demo Templates

Just 1 click and you have a real-world set of working templates


The latest version of Freeform is 1.2.0. The chart below shows the current technical requirements and compatibility for the latest version of Freeform.

  • Craft 2.6+ (2.6.2780 or later)
  • PHP 5.4+
  • MySQL 5.1+


The following is a list of add-on items for Freeform that expand its capabilities.

Freeform Salesforce Lead

Freeform Salesforce Lead

Salesforce CRM API integration for Solspace Freeform.

$149.95   Add to Cart
More Info  
Freeform MailChimp

Freeform MailChimp

MailChimp Mailing List API integration for Solspace Freeform.

Free (included) More Info  
Freeform Constant Contact

Freeform Constant Contact

Constant Contact Mailing List API integration for Solspace Freeform.

More Info  
Freeform HubSpot Deals

Freeform HubSpot Deals

HubSpot CRM Deals API integration for Solspace Freeform.

$149.95   Add to Cart
More Info  
Freeform Campaign Monitor

Freeform Campaign Monitor

Campaign Monitor Mailing List API integration for Solspace Freeform.

More Info  

  What People Are Saying

  Documentation     Changelog


1.2.0 (November 22, 2016) #

  • Added ability to change the value for single Checkbox fields. By default, it now has a value of Yes, which can be overwritten with any value you want. The front end however, will always display the value as 1, but upon submission, the value will be switched to the one you have set.
  • Added formAttributes and inputAttributes properties in customAttributes for things like novalidate, data-form-id, etc.
  • Added useRequiredAttribute: true property to Form and Field object custom attributes. Fields that have been set to be required with get the required attribute added to their input.
  • Added Submission object variables to email notification templates.
  • Updated Freeform demo templates to use 'slug' instead of 'handle' for template routes.
  • Fixed some bugs where Freeform and API Integrations were not fully compatible with PHP 5.4 and 5.5.
  • Fixed a bug where Email fields that were required were being automatically assigned 'required' attribute. To add this back, use useRequiredAttribute: true override.
  • Fixed a bug where Freeform would conflict with other plugins' navigation tabs.
  • Fixed a bug where Radio Group and Select fields would display "Checked?" instead of "Selected?".
  • Fixed a bug where default Submit button markup would cause issues with AJAX.
  • Fixed a visual bug where Checkbox group fields were automatically adding an "All" option in CP Edit view, and checking off all values if none were selected.
  • Fixed a visual bug with Composer field placeholder that would stick when using Chrome.

1.1.0 (November 2, 2016) #

  • Added option per form to store data in the database or not (send emails or API integration only).
  • Added ability to duplicate forms.
  • Updated Email Notification Template editor to match the HTML editor inside Composer.
  • Updated field handles to now be overridable per form inside Composer.
  • Updated forms to improve AJAX handling and added AJAX implementation documentation.
  • Updated Composer page tabs to be scrollable when they extend past the available width, moved Add Page (+) button to be right aligned.
  • Fixed a bug where quick create fields, notifications and formatting templates options would be displayed inside Composer to users/groups without sufficient privileges.
  • Fixed a bug where clicking the main Freeform nav item would show an 'Unauthorized' message to users/groups that did not have access to Freeform Settings page.
  • Fixed a bug where inline errors would only display if form.hasErrors conditional was used inside the formatting template.
  • Fixed a bug where saving multi-page forms with no fields on it inside Composer would cause the form to no longer display when opening it again.
  • Fixed a bug where id and overrideValues (for hidden fields) parameters did not work for freeform.form.render() function.
  • Fixed a bug where freeform.form function would not work with overrides when renderTag was used.

1.0.1 (October 27, 2016) #

  • Fixed a bug where logged out guests would receive a permission error when submitting forms.
  • Fixed a bug where Salesforce integration failed when sending empty required fields.

1.0.0 (October 24, 2016) #

  • Initial release.

  Pro Services

Need help with an implementation of Freeform? Need Freeform to do more? We're available for hire!

  • Consulting services
  • High priority / urgent support
  • Implementation of Freeform onto your site
  • Modify Freeform to work for your site's needs
  • Build custom plugins for your site
  • API integrations
  • Website development services

If you're interested in any of the above services, or have questions about them, fill out the form below to begin our conversation!