Updating from Freeform 2.x

WARNING

Freeform 3 has now proven to be stable for upgrades from Freeform 2.x. However, due to the nature of this update (consolidating Lite + Pro + Payments editions plugins plus other big changes) we recommend anyone upgrading from Freeform 2.x to do so carefully in a development environment and follow the special instructions below.

The Freeform 2.x to Freeform 3.x upgrade is special for a variety of reasons, each of which carry implications:

  • It consolidates the 3 separate plugins (Lite + Pro + Payments) into a single plugin with real editions.
  • Some Lite features are now Pro only, while the Payments plugin features are now part of the Pro edition (see Key Changes table below).
  • Lite customers have all been granted access to Freeform 3.x Pro licenses (freely available with valid (non-expired) licenses, otherwise an renewal is required).
  • Freeform Lite and Pro both have reduced prices now!
  • The package name for Freeform has changed from craft3-freeform to craft-freeform.
  • There may be a bit of a clean-up process for Pro and/or Payments plugins (if applicable).

Key Changes

Freeform 3 brings some exciting new features to Freeform, but there have also been a few changes to what's offered between the Lite, Pro and Payments editions. The chart below will explain those changes so you know how to account for them in the future. All existing Lite customers prior to version 3 becoming available have been granted access to Freeform 3.x Pro licenses (freely available with valid (non-expired) licenses, otherwise an renewal is required).

WARNING

All Freeform customers' v2 Lite licenses have been upgraded to v3 Pro licenses as of June 11, 2019. If your Freeform license(s) have expired, and you wish to renew to get access to Freeform 3, please be aware that your old Lite license is now a single Pro license and your old Pro and/or old Payments license(s) are discontinued. This means that if you originally had old Lite and old Pro, you now have new Pro (all you need) and your old Pro (seperate plugin license) essentially no longer exists. Renewals will only require renewing your new Pro license.

If you wish to downgrade your new Pro license to a new Lite license, please contact the Craft Support Team for assistance, and they'll be happy to help. We apologize for any confusion and inconvenience. Just be aware that some features from Freeform 2 Lite are no longer available in Freeform 3 Lite (see below).

TIP

For a full list and comparison of all features available to Freeform 3 Lite and Pro, please check out the Compare Chart documentation.

✓ Added  |  ↻ Improved  |  × Removed  |  ✓/× No Change

Pricing & Support

Lite 3

Pro 3

Cost $99 $149
$159
Renewal (optional) $49/yr $69
$79
Craft Compatibility 3.1+ 3.1+

Forms

Build User registration forms ×
Built-in JS plugin (for improved flexibility)

Fields

⎼ Opinion Scale ×
⎼ Rich Text block ×
⎼ Confirm ×
⎼ Password ×
⎼ Number, Phone, Website Uses designated input types now Uses designated input types now
Populate fields from URI query string

Email Notifications

HTML Email body
Text Email body
Include Reply-to, CC and BCC
Attach predefined Assets/files to be included ×
Retroactively resend email notifications ×

Submissions

Edit submissions on front end ×
Search on submission data on front end
Limit form to 1 submission per user ×
Map submission data to Craft Elements ×
Relate submissions to Craft Elements ×
Automatically purge submission data ×

Exporting

Export submission data
CSV

Excel, CSV,
XML, JSON, Text

Spam Protection

Built-in Honeypot
Javascript Enhancement for Honeypot
Spam folder
reCAPTCHA v2 Checkbox
reCAPTCHA v2 Invisible ×
reCAPTCHA v3 ×

API Integrations

CRM API integrations ×
Mailing List API integrations ×
Webhooks ×
Slack, Zapier, generic
Accept Payments (Stripe) N/A
+$59

Included
+$59

Usability

Rename plugin ×

✓ Added  |  ↻ Improved  |  × Removed  |  ✓/× No Change

Updating from 2.x

To transition from Freeform 2.x to Freeform 3.x, please follow the instructions below very carefully.

WARNING

All Freeform customers' v2 Lite licenses have been upgraded to v3 Pro licenses as of June 11, 2019. If your Freeform license(s) have expired, and you wish to renew to get access to Freeform 3, please be aware that your old Lite license is now a single Pro license and your old Pro and/or old Payments license(s) are discontinued. This means that if you originally had old Lite and old Pro, you now have new Pro (all you need) and your old Pro (seperate plugin license) essentially no longer exists. Renewals will only require renewing your new Pro license.

If you wish to downgrade your new Pro license to a new Lite license, please contact the Craft Support Team for assistance, and they'll be happy to help. We apologize for any confusion and inconvenience. Just be aware that some features from Freeform 2 Lite are no longer available in Freeform 3 Lite (see below).

  1. BACKUP YOUR SITE FILES AND DATABASE.
  2. Update to the latest versions of Lite, Pro and/or Payments. This isn't exactly required, but it will help narrow down any potential issues (isolate whether any potential issue has to do with an old Freeform 2.x migration or the 3.x migration, etc).
  3. Carefully review the changelog for Freeform 3.x as well as the new key features/changes table above.
  4. If your Freeform license(s) are currently expired, you will need to renew the new Freeform 3 Pro license (formerly your old Freeform 2 Lite license, regardless of which edition you had before). If you had an old Freeform 2 Pro license, it essentially no longer exists. We recommend renewing the license inside the Craft ID site this time: Renew the new Freeform 3 Pro license
  5. We recommend updating via Composer from the Terminal:
    • Open your Craft site's main composer.json file and adjust the following information (example) FROM:




       
       
       



      "require": {
          "php": ">=7.0.0",
          "craftcms/cms": "^3.1.0",
          "vlucas/phpdotenv": "v2.4.0",
          "solspace/craft3-freeform": "^2.5.0",
          "solspace/craft3-freeform-pro": "^2.5.0",
          "solspace/craft3-freeform-payments": "~1.0.0",
          "solspace/craft3-calendar": "^2.0.0"
      },
      
      1
      2
      3
      4
      5
      6
      7
      8
      9
    • Change it TO (note change of solspace/craft3-freeform to solspace/craft-freeform also):




       



      "require": {
          "php": ">=7.0.0",
          "craftcms/cms": "^3.1.0",
          "vlucas/phpdotenv": "v2.4.0",
          "solspace/craft-freeform": "^3.0.0",
          "solspace/craft3-calendar": "^2.0.0"
      },
      
      1
      2
      3
      4
      5
      6
      7
    • Open your Terminal and go to your Craft project: cd /path/to/project
    • To run the available updates for your site, run composer update
  6. Proceed to Craft control panel and click the Finish Updates button when it shows.
    • The Freeform 3.x migration and Composer update should have updated Freeform Lite 2.x to Freeform 3.x with a Pro edition license, and have uninstalled and removed the old Freeform Pro 2.x and Freeform Payments plugins.
  7. Go to the Plugins section of your Craft 3 control panel (Craft CP -> Settings -> Plugins) and ensure that you have the Pro edition of Freeform. If not, follow the steps below:
    • Click on the Lite \ Trial flag/button, which will take you to the Freeform product page inside the Craft Plugin Store. Switch editions, Step 1
    • Click on the Reactivate button to activate the Pro edition for your site. Switch editions, Step 2
    • Alternatively, you could edit the edition setting inside Craft's Project Config file to have a value of pro.
  8. Carefully review Freeform inside the control panel and in your templates and ensure that everything works correctly and/or necessary updates to forms/templates/settings are made. If you ever use the demo templates to review/test/experiment, please note that we've made large updates to the demo templates for Freeform 3.x, so you may wish to reinstall them.
  9. Ignore any previous old Pro and old Payments licenses you may have had, as these are now discontinued as of June 11, 2019. Your old Lite license is now a new Pro license, which grants you access to all of Freeform's features.



Icons made by srip from www.flaticon.com is licensed by CC 3.0 BY.

Last Updated: 8/8/2019, 2:05:06 AM