Knowledgebase

How to Enable Maintenance Mode in WHMCS

  • 0

How to Enable Maintenance Mode in WHMCS

 

When managing a hosting business, there are times when you need to perform updates, configure settings, troubleshoot issues, or make changes to your WHMCS installation. During these activities, allowing clients to access the system may cause errors or interruptions.

WHMCS provides a Maintenance Mode option that allows administrators to temporarily disable client access while keeping the system protected during maintenance activities.

In this guide, we will explain what Maintenance Mode in WHMCS is, why it is useful, and how to enable it properly.

 

What is Maintenance Mode in WHMCS?

 

Maintenance Mode in WHMCS is a feature that temporarily prevents clients from accessing the WHMCS client area while administrators perform important tasks.

When enabled, visitors will see a maintenance message instead of the normal WHMCS interface. Administrators can still access the admin area to manage settings, update configurations, and complete maintenance work.

 

Why Use Maintenance Mode in WHMCS?

 

There are several reasons to enable Maintenance Mode in WHMCS:

  • Performing WHMCS upgrades

  • Installing or testing modules

  • Changing system configurations

  • Troubleshooting technical issues

  • Updating themes or templates

  • Performing database maintenance

  • Preventing client interruptions during changes

Using Maintenance Mode helps provide a better experience by avoiding broken pages or incomplete updates.

 

How to Enable Maintenance Mode in WHMCS

 

Follow these steps to enable Maintenance Mode in WHMCS:

 

Step 1: Login to WHMCS Admin Panel

 

First, log in to your WHMCS administrator dashboard using your admin credentials.

 

 

 

 

Step 2: Open General Settings

 

From the WHMCS admin dashboard, go to:

  • Configuration Icon → System Settings

 

 

 

  • Select General Settings

This section contains the main configuration options for your WHMCS installation.

 

 

 

 

Step 3: Enable Maintenance Mode

 

  • Under General Section.

 

 

 

 

  • Navigate to the Maintenance Mode option.

Enable the maintenance mode setting and add a custom message that will be displayed to visitors.

Example message:

"Website maintenance is currently in progress. Please check back soon."

 

 

 

Step 4: Save Changes

 

After enabling Maintenance Mode, click the Save Changes button.

Your WHMCS client area will now display the maintenance page instead of allowing normal client access.

 

 

 

 

Customizing the Maintenance Message

 

WHMCS allows you to customize the message shown during maintenance.

A good maintenance message should include:

  • Reason for maintenance (optional)

  • Expected completion time

  • Support contact information

  • Alternative ways to contact your team

Example:

"We are currently performing scheduled maintenance to improve our services. Our team will restore access shortly. For urgent support, please contact our support team."

 

 

 

How to Disable Maintenance Mode in WHMCS

 

Once your maintenance work is completed, you should disable Maintenance Mode to restore normal client access.

Follow these steps:

  1. Login to the WHMCS Admin Area

  2. Go to Configuration → System Settings → General Settings

  3. Open the Maintenance Mode option

  4. Disable the setting

  5. Save changes

Your WHMCS client portal will become available again.

 

 

 

 

Best Practices When Using Maintenance Mode

 

To avoid issues while using Maintenance Mode in WHMCS, follow these best practices:

 

  • Inform Clients Before Maintenance
  • Perform Backups Before Changes
  • Test Changes Before Going Live
  • Disable Maintenance Mode After Completion

 

Conclusion

 

Maintenance Mode in WHMCS is a useful feature that helps administrators safely manage updates, configurations, and technical changes without affecting clients. By enabling Maintenance Mode before performing important tasks, you can prevent errors and provide a smoother experience for your customers.

Learning how to Enable Maintenance Mode in WHMCS helps hosting providers maintain their WHMCS environment professionally and efficiently.


Was this answer helpful?