This document is for an older version of

Freeform

.

View latest version →

Freeform Freeform for ExpressionEngine

Installing & Updating

Requirements

Solspace Freeform Express, Lite and Pro editions are all compatible with EE5, EE4 and EE3, with mostly the same minimum requirements as listed on the ExpressionEngine Requirements page:

ExpressionEngine 4.x/5.x

  • PHP 7 or newer
  • PHP iconv enabled
  • MySQL 5.6 or newer
  • Windows and macOS browsers:
    • Chrome 21 or newer
    • Firefox 28 or newer
    • Safari 9.0 or newer
    • Internet Explorer 11 or newer
    • Microsoft Edge

ExpressionEngine 3.5.x

  • PHP 5.4 or newer
  • PHP iconv enabled
  • MySQL 5.1 or newer
  • Windows and macOS browsers:
    • Chrome 21 or newer
    • Firefox 28 or newer
    • Safari 9.0 or newer
    • Internet Explorer 11 or newer
    • Microsoft Edge

Installing Instructions

  1. Unzip the download package:
    • Copy the freeform_next folder to your EE site's ./system/user/addons/ directory.
    • Open the themes folder and copy the freeform_next folder to your EE site's ./themes/user/ directory.
  2. Go to the Add-Ons area (under Developer navigation tab), scroll to down to the Third Party Add-Ons section, and find Freeform Pro (or Freeform Lite) in the list, and click the Install button.

TIP

The new Freeform can be used alongside classic Freeform/Freeform Pro (Freeform Classic) installations if you're wanting to try out Freeform.

Updating Instructions

TIP

If you're switching from Freeform Classic to the new Freeform, please see the Switching from Freeform Classic documentation to learn more about the differences, and then view the Migration utility documentation to prepare your site for migration. Freeform can be used alongside classic Freeform/Freeform Pro (Freeform Classic) installations if you're wanting to try out and/or switch to Freeform.

TIP

If you're upgrading from Freeform Lite to Freeform Pro, you can follow these same instructions below. There will be no update button/process as it is not required, though you may see the Update button if the version number is greater (e.g. Lite 1.5.3 to Pro 1.6.4).

Freeform has its own Update Service built in, which means that every time there's an update available, an Updates Available nav item will show up in the Freeform add-on area of the EE control panel. You can then review the changelog there, or view it here.

Freeform's Built in Update Service

To download the update, simply click the Get Latest Version button, and you'll be taken to your account area on the Solspace site where you can log in and download the updated package for Freeform. Then follow the steps below:

  1. Within your EE site's ./system/user/addons/ and ./themes/user/ directories, delete the freeform_next folders.
  2. Unzip the download package:
    • Copy the freeform_next folder to your EE site's ./system/user/addons/ directory.
    • Open the themes folder and copy the freeform_next folder to your EE sites ./themes/user/ directory.
  3. Go to the Add-Ons area (under Developer navigation tab), scroll to down to the Third Party Add-Ons section, and find Freeform Pro (or Freeform Lite) in the list, and click the Update button.

Quick Setup

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

  1. Customize and configure Solspace Freeform settings by visiting the Settings page (Developer > Add-Ons > Freeform > Settings).
  2. Freeform includes its own granular permission options. See Permissions documentation for more information.
  3. Install the Demo Templates (Developer > Add-Ons > Freeform > Settings > Demo Templates) to get Freeform up and running on the front end with just a couple clicks!