Search The Hostwinds Guides Knowledge Base

How to Update WHMCS

Share This Article [TheChamp-Sharing]

If using a Hostwinds White Label Plan, the WHMCS version needs to match our current version of WHMCS, otherwise, the White Label Functionality will not work properly.

One of the easiest things you can do to keep your WHMCS secure and with the newest features, is to keep it up to date. This way, you will get all the latest features of WHMCS, and not have to worry if you are missing out. This guide will go through the Update process as well as the Configuration Settings that can be set for your WHMCS.

Where To Find The Option To Update Your WHMCS

Step One: Log into your WHMCS Dashboard. (Usually located at or wherever the WHMCS is installed by default)

Step Two: From the top menu options, you will want to navigate to Utilities -> Update WHMCS to find the WHMCS Update Page.

WHMCS Utilities Update WHMCS Page Menu Button Location

Once there the Page should look similar to the following,

WHMCS Utilities Update WHMCS Page Main Overview

Step Three: Clicking the Update Now button from this page will prompt you to confirm before applying the update. It is recommended to create a Database Backup of the WHMCS Database, just in case.

WHMCS Utilities Update WHMCS Confirm Update First Dialog Box

Step Four: Click Continue if you are ready to proceed and it will bring you to a new confirmation screen, as a last confirmation. As once the Update process has been started it cannot be stopped, and can take some time to complete. Click Begin Update when you are ready.

WHMCS Utilities Update WHMCS Being Update Final Confirmation

How To Check For Updates

Following the same steps as above to get to the WHMCS update page, there will be a button labeled, Check Now, that will allow you to force WHMCS to check for any recent updates.

WHMCS Utilities Update WHMCS Check For Updates Now Button

Change Logs and Release Notes

With each update made to WHMCS, there will be a change log, and possibly some release notes. The change log provides valuable information that can help you in your decision to upgrade the WHMCS installation. It will have a list of everything changed in the most recent version (or the version you are viewing the log for). Clicking on the Release Notes or Change Log links from the Update WHMCS page below the Update Now button, will open a new tab (or window) with the relevant information.

Here is an example of what the Change Log might look like,

WHMCS Utilities Update WHMCS Page ChangeLog example

Here is what the Release Notes may appear like,

WHMCS Utilities Update WHMCS Page Release Notesexample

With the release notes, if you scroll down a little bit, you can also find a Change Log there as well.

Configuring Your Update Settings

There may be some times, where you only want to use a certain branch of updates, or change what displays to your clients and users during the update. To get to this page, you will first want to navigate to the WHMCS Update page using the steps above. Then you will want to click on the Configure Update Settings button to bring up the dialog.

WHMCS Utilities Update WHMCS Configure Update Settings Button Location

From the Configure Update Settings you will have the option to input some settings that determine what goes on with the Updates.

  • Update Channel – This option allows you to choose which branch you will receive and check for updates from. There is the option for Stable (Recommended), Release Candidate, Beta, and Current Version. The Current Version is useful if you have any dependencies that can only be fulfilled with your current Version of WHMCS, or if you have some values hardcoded that require that specific version.
  • Temporary Path – This is where WHMCS will store files while it is updating. It is a temporary path, and the files here are not intended to last long after the update has finished. Recommended to be outside of public_html (to prevent sensitive data from being seen).
  • Maintenance Message – Here you can set the message that will display to your sites visitors and users while an update is ongoing.
WHMCS Utilities Update WHMCS Page Configure Update Settings Example

If you should have any questions or would like assistance, do feel free to contact us through Live Chat or by submitting a ticket with our Technical Support team.