# Beta Testing

# Current Beta

The Freeform 4.0 beta has finished and been released publicly.

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

# Overview of Changes

We're excited to announce that the Freeform 4 beta for Craft 4 is now available! Since Craft announced its annual release cycle, we have decided we will sync our major releases along with them. We will continue to add and improve exciting new features throughout the year, but major version Craft compatibility and breaking changes will be reserved for the major releases. Because of this, while Freeform 4 may not have many observable new features or changes, a lot of that has happened under the hood.

The Freeform 4.0 update focuses primarily on Craft 4 compatibility and a number of breaking changes that will allow us to continue to improve Freeform in the future. Please see the special Freeform 4 upgrade guide here.

# Requirements

Freeform 4.0 requires Craft 4. It has the same updated server requirements as Craft 4.

# Installation

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
   

   1
   
2. The beta can be installed one of two ways:

   composer require solspace/craft-freeform:^4.0.0-beta.1
   

   1
   

   composer require solspace/craft-freeform && php craft plugin/install freeform
   

   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.

# Updating

If you're wanting to update from an older version of the Freeform 4 beta to a newer version:

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 ^4.0.0-beta.1
   • Your final composer.json file might have something like this:
     
     
     
     

      

     
     
     

     "require": {
         "craftcms/cms": "^4.0.0-beta.1",
         "vlucas/phpdotenv": "^5.4.0",
         "solspace/craft-freeform": "^4.0.0-beta.1",
     },
     

     1
     2
     3
     4
     5
     
3. Open your terminal and go to your Craft project:

   cd /path/to/project
   

   1
   
4. To run any available updates for your site, run:

   composer update
   

   1
   
5. Proceed to Craft control panel and click the Finish Updates button if it shows.

# 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.

# 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! 😃

• Report an Issue
• Feature Requests
• Ask a Question
• Private Support Ticket