Version 8.6 Release Notes

From WHMCS Documentation

Release Information
Version: 8.6.2
Release Type: Maintenance
Latest Update: 20th June 2023
Distribution Types: Full and Via Automatic Updater

For more information on WHMCS 8.6's important changes and exciting features, see New and Improved in WHMCS 8.6.

Version History

8.6.0Beta 17th September 2022
8.6.0RC 16th October 2022
8.6.0General Availability3rd November 2022
8.6.1Maintenance30th November 2022
8.6.2Security20th June 2023


Download the latest version of WHMCS from

Upgrade Process

WHMCS 8.0 and above requires PHP 7.2 or later. WHMCS 8.0 introduced support for PHP 7.4, and WHMCS 8.6 introduced support for PHP 8.1.

Make certain that you update to a WHMCS version that supports your desired PHP version or higher before updating PHP.

  • The Automatic Updater only displays updates if you are running a PHP version that is compatible with that WHMCS version.
  • For example, if you are running PHP 7.1 or earlier, you must update to PHP 7.2 or later before updating to WHMCS 8.0 or higher.

Upgrade Instructions

Automatic Updating

If you are running WHMCS 7.0 or later, you can use the built-in Automatic Updater.

Go to Utilities > Update WHMCS to begin the process.

If the update was released recently, you may need to click Check for Updates before the update will be available.

Release Notes

OAuth2 Support for Microsoft® Services

If you use Microsoft's mail services, our newly-enhanced configuration options allow you to comply with Microsoft's upcoming requirements for OAuth2 authentication. This includes any Microsoft service that is compatible with Microsoft Azure® apps, like Hotmail®, Microsoft Outlook®, Microsoft 365®, and several others. OAuth2 offers enhanced security and replaces traditional password-based authentication.

  • You can configure Microsoft services for email importing at Configuration () > System Settings > Support Departments.
  • You can configure Microsoft services as your WHMCS installation's mail provider at Configuration () > System Settings > General Settings in the Mail tab.

Learn More...

Activate Payment Gateways via Apps & Integrations

You can now only activate new payment gateways through the list of modules at Configuration () > Apps & Integrations. This makes it easier to view the full list of all of our available and recommended payment gateway modules.

After you activate a payment gateway, you can configure it in the newly-streamlined list at Configuration () > System Settings > Payment Gateways. This list will continue to display all of your activated payment gateways and their configuration options.

Learn More...

PHP 8.1 Support

WHMCS now supports PHP 8.1 for WHMCS 8.6 and higher. If you want to move to PHP 8.1, make certain that you update to WHMCS 8.6 before updating PHP.

Our support for PHP 8.1 requires ionCube Loader® 12. Due to limitations in ionCube's support, we are unable to officially support PHP 8.0.

Learn More...

Deprecation and Removal Notices

Removed Modules

Updating to WHMCS 8.6 will attempt to remove the following discontinued modules if they are not actively in use:

After the update, you can check the Activity Log section at Configuration () > System Logs for a list of removals.


For a list of changed files and a graphical view of the exact changes, see the GitHub™ repositories below.

Twenty-One Theme

The following link provides a comparison of changes between 8.5.2 and 8.6.2:

Six Theme

The following link provides a comparison of changes between 8.5.2 and 8.6.2:

Standard Cart Order Form

The following link provides a comparison of changes between 8.5.2 and 8.6.2: