Skip to main content

Installing & Updating

​Requirements

Solspace Freeform has mostly the same minimum requirements as listed on the ExpressionEngine Requirements page:

  • ExpressionEngine 7.x
  • PHP 8.0-8.3
  • PHP iconv enabled
  • MySQL 5.6 or newer

​Freeform currently only supports PHP 8.0 through 8.3.

  • PHP 8.4+ is not fully supported at this time because adding full compatibility would require dropping support for PHP 8.0 and 8.1.
  • Freeform 3.3.x no longer supports PHP 7.4. If your site requires PHP 7.4, please use Freeform 3.2.x instead.

​Installing Instructions

1

Unzip the Download Package

  • Open the EE7 folder.
  • Copy the freeform_next folder to your EE site's ./system/user/addons/ directory.
  • Within the themes folder, copy the freeform_next folder to your EE site's ./themes/user/ directory.
2

Install the Add-on

  • Go to the Add-Ons page in the EE control panel.
  • Find Freeform in the list, and click the Install button.

​Updating Instructions

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. The migration is best run on Freeform 1.x for EE3-5.

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.

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

1

Prepare your Site

  • Inside your EE site's ./system/user/addons/ directory, delete the freeform_next folder.
  • Inside your EE site's ./themes/user/ directory, delete the freeform_next folder.
2

Unzip the Download Package

  • Open the EE7 folder.
  • Copy the freeform_next folder to your EE site's ./system/user/addons/ directory.
  • Within the themes folder, copy the freeform_next folder to your EE site's ./themes/user/ directory.
3

Update the Add-on

  • Go to the Add-Ons page in the EE control panel.
  • Click on the Updates tab near the top, and find Freeform in the list.
  • Click the Update button.

​Quick Setup

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

1

Customize and configure Solspace Freeform settings by visiting the Settings page (Add-Ons → Freeform → Settings).

2

Freeform includes its own granular permission options. See Permissions documentation for more information.

3

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

Page Feedback