• Document Up to Date
  • Updated On 4.2.0

Breaking Changes in CrafterCMS 4.2.x

This section covers changes that might affect your CrafterCMS projects, as well as other considerations before upgrading. Please review the following and apply changes as required:

  • CrafterCMS 4.2.x requires Java 21.
    See Requirements for more information on CrafterCMS requirements.

  • CrafterCMS 4.2.x now uses Jakarta EE.
    The jakarta.* namespace is now used instead of javax.*. To update your project, find and replace javax with jakarta in your Groovy code or Java if you are bringing in jars with Grab.

Upgrading 3.1.x Sites

  • MongoDB in CrafterCMS Social and Profile has been updated. To upgrade MongoDB in your installation, see Upgrading MongoDB

  • CrafterCMS 4.1.x onward requires Git.
    See Requirements for more information on CrafterCMS requirements.

  • CrafterCMS 4.1.x onward has a new Studio UI. To get the same Sidebar you’re used to, update the User Interface Configuration

  • Update ICE to move to XB

  • Studio and Engine SAML configuration now uses a key and certificate for configuration instead of using keystore.
    See Engine SAML2 Configuration and Studio SAML2 Configuration for more information.