Freeform Documentation

Learn the basics, and get to know Freeform inside and out.

Freeform 1.x Docs


Requirements #

Solspace Freeform mostly meets the same requirements as listed on the Craft Requirements page.

  • Craft 3.0.0 or later
  • PHP 7.0+
  • MySQL 5.5+ (with InnoDB) or PostgreSQL 9.5+
  • BC Math or GMP PHP extensions (usually included in most server environments)
  • Windows and OS X browsers:
    • Chrome 29 or later
    • Firefox 28 or later
    • Safari 9.0 or later
    • Internet Explorer 11 or later
    • Microsoft Edge

Watch Tutorial VideoWatch the Installing and Configuring Freeform tutorial on CraftQuest!

Installing Instructions #

To install Freeform, simply:

  1. Go to the Plugin Store area inside your Craft control panel and search for Freeform.
  2. Choose to install Freeform Lite and/or Freeform Pro (Pro requires Lite to be installed) by clicking on them.
  3. Click on the Try button to install a trial copy of Freeform.
  4. Try things out and if Freeform is right for your site, purchase a copy of if through the Plugin Store when you're ready!


Freeform can also be installed manually through Composer:

  1. Open your terminal and go to your Craft project: cd /path/to/project
  2. Then tell Composer to require the plugin: composer require solspace/craft3-freeform
    • If you'd like Freeform Pro, also run: composer require solspace/craft3-freeform-pro
    • If you'd like Freeform Payments, also run: composer require solspace/craft3-freeform-payments
  3. In the Craft control panel, go to Settings → Plugins and click the Install button for Freeform Lite (and Freeform Pro if you're using Pro edition).

Quick Setup #

Follow the steps below to quickly get Solspace Freeform setup in minutes.

Settings #

To customize and configure Solspace Freeform settings, visit the Settings page (Freeform > Settings).

Permissions #

Freeform ties into regular Craft User Group Permissions. Simply visit the Craft permissions page for the applicable user group(s) (Settings > Users > User Groups) to grant/edit/remove permissions to Freeform. See Permissions documentation for more information.

Demo Templates #

Install the Demo Templates (Freeform > Settings > Demo Templates) to get Freeform up and running on the front end with just a couple clicks!