8.4 Releases


Released 29/08/2023

Release Notes

System Requirement Changes

The minimum php version has been updated to php 8.1. The supported versions are now php 8.1 and 8.2.

To visit the SuiteCRM 8.4.x Compatibility Matrix please see here.

Backward Incompatible Changes

1. Default extension renamed to defaultExt

The 'extensions/default' package has been renamed to 'extensions/defaultExt'.

The upgrade process does not remove the old extensions/default package. Any changes on it should be manually moved to the extensions/defaultExt.

The extensions/default is going to be removed in a future version.

2. DisplayType logic moved to displayLogic

The displayType logic within the metadata logic entry has been deprecated. This will be removed in a future version.

There is a now a more flexible metadata entry that should be used, named displayLogic. See Field Display Logic guide for more information.


It is no longer required to stop on 8.3.1 before upgrading to the following versions.

The code that caused this issue has been reverted. It is again possible to upgrade from 8.2.0 (or 8.3) directly to 8.4+, For more information about upgrades please see the Upgrade Documentation.


  • We have updated the Field Logic page. This is now split into different pages.

    • We have added a new page explaining operators with examples here also.

  • We have added documentation about the Process Api.

Bug Fixes

  • PR: 299 - Fix #215 - Cant Create records from custom modules

  • PR: 286 - Fix #286 - Field Layout

  • PR: 285 - Fix #285 - Readonly Field on Field Logic

  • PR: 269 - Fix #296 - Fix case update notes

  • PR: 10116 - Fix #10053 - Issue when creating new tabs on Dashlets

  • PR: 10106 - Fix #10105 - Fix 500 error when saving audited numeric field

  • PR: 10108 - Fix #10107 - Function getRelatedId is unable to return NULL values


Nav Bar Redesign

The Nav Bar within Suite has went through some changes:

Nav Bar

The + will now show you actions relating to the module you are on, as well as Quick Actions to create a record in another module:

Contact Actions

Floating Save

SuiteCRM now has a floating save meaning no matter where you are on a record you can save:

Nav Bar

Developer improvements
Smarty Upgrade

Smarty, the templating engine used in SuiteCRM 7.x, has been upgraded to v4 which brings some minor performance improvements and better compatibility going forward.

PHP 8.2 Support

This release brings a number of adjustments and updates in order to support PHP 8.2.

This includes:

  • Removal of deprecated functions/ features.

  • Update functions to PHP 8.2 standard.

  • Fixed Unit & Acceptance Tests

  • Executed Rector to clean up code.

  • Fixed code to eliminate warnings from logs.


We would love to have your feedback and input to help make SuiteCRM 8 great for everyone.

Special thanks to the following members for their contributions and participation in this release!

If you have found an issue you think we should know about, or have suggestion/feedback, please Submit An Issue.

If you want to get involved and submit a fix, fork the repo and when ready please Submit A PR - More detail for developers can be found here.

Please visit the official website to find the appropriate upgrade package.

To report any security issues please follow our Security Process and send them directly to us via email security@suitecrm.com

Content is available under GNU Free Documentation License 1.3 or later unless otherwise noted.