Beta Testing

As part of our commitment to developing and releasing reliable, stable software, we now put all minor feature releases through thorough beta testing.

The Freeform 3.10 beta has now finished and been released publicly.

Stay tuned for the Freeform 3.11 beta...

If you wish to join future betas, please check out the instructions and guide below.


While we carefully develop new features and put all of it through rigorous alpha and beta testing, we cannot guarantee that there will be no major issues in beta software. It's also possible that specific edge case scenarios may have been missed, etc. For this reason, we strongly advise you not to use beta versions in production environments.


Before you proceed, please ensure the following:

  1. Make a copy of your site for local development testing.
  2. Backup the database and database.
  3. If this is an upgrade, carefully examine all aspects of your site and features after upgrading to ensure they're working correctly.

Overview of Changes

The primary focus of Freeform 3.10 is to add support for GraphQL and refine a wide variety of other features to behave more robustly.

Here's an overview of the key changes in Freeform 3.10:

  • Added support for GraphQL.
  • Added the ability to specify a custom Payment description inside the form builder to show inside Stripe payments.
  • Added ability to specify a Text-only version of email notifications when using the template file approach ({# text #}{# /text #}).
  • Updated Freeform to automatically generate Text-only versions when no Text-only version is specified in the email notification template.
  • Updated AJAX to work with multipage forms, including Stripe Payment forms.
  • Overhauled the Freeform Javascript plugin to be more robust, reworked the API to make it way more developer friendly. Made it easier for anyone to adjust or complement form functionality regardless of their particular site setup.
  • Various improvements to the Weekly Digest feature (some still in progress).

Other changes still in progress:

  • More improvements to the Weekly Digest feature.
  • Refining of Freeform settings (more granular user group permission controls).


There are no new minimum server requirements for Freeform 3.10. It has the same requirements as Freeform 3.9.


Betas cannot be installed from the Craft control panel. They must 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 v3.10 beta of the plugin: composer require solspace/craft-freeform:^3.10.0-beta.1
  3. In the Craft control panel, go to Settings → Plugins and click the Install button for Freeform.
    • If you'd like to try out Freeform Pro, click on the Lite / Trial button beside the Freeform plugin name and inside the Plugin Store product page for Freeform, you can click on Try button for the Pro edition.


Betas cannot be updated from the Craft control panel. They must be updated manually through Composer:

  1. Open your Craft site's main composer.json file.
  2. Adjust the version number for solspace/craft-freeform to ^3.10.0-beta.1
    • Your final composer.json file might have something like this:


    "require": {
      "craftcms/cms": "^3.4.0",
      "vlucas/phpdotenv": "v2.4.0",
      "solspace/craft-freeform": "^3.10.0-beta.1",
  3. Open your terminal and go to your Craft project: cd /path/to/project
  4. To run any available updates for your site, run composer update
  5. Proceed to Craft control panel and click the Finish Updates button if it shows.


By specifying ^ before the version number (^3.10.0-beta.1), for future updates you can just run composer update and it'll grab the latest available version.

Providing Feedback

We would greatly appreciate it if you are able to provide us with routine feedback throughout your testing and usage of the beta. Even if you aren't using any of the new features or changes, providing feedback allows us to get a better idea of how things are going for all kinds of websites.

To make this even easier, we've included a Beta Feedback widget that displays in the Freeform control panel. Just click a star rating (5/5 to indicate if everything is going well, or less if you are experiencing any issues) and if you have anything to clarify, fill in a quick note in the textarea and click submit. You can optionally include your email address, which will also help us get in touch with you to get more information about any issues and/or assist you as necessary.

Feel free to also just use a Private Support Ticket or report an issue via GitHub Issues.


This widget will only display during betas. If you wish to disable it from displaying, add FREEFORM_DISABLE_BETA_FEEDBACK_WIDGET=1 to your .ENV file.

Beta Feedback Widget

Beta Feedback Widget opened

Reporting Issues

If you're experiencing any issues with this beta, please let us know ASAP and we'll be happy to assist you with the issue. If everything is working very well for you, we would appreciate you taking the time to let us know that too! 😃

Last Updated: 1/6/2021, 1:21:28 AM