Troubleshooting the Client Area
If you encounter errors or issues while working with the Client Area, your online store, or the shopping cart, see the sections below to start troubleshooting and resolve the issue.
- For more information, see Clients and the Client Area.
- For general steps to troubleshoot problems in WHMCS, see Start Troubleshooting.
General Issues
You may encounter the following common issues:
| Error or Issue | Cause | Next Steps |
| The Admin Dashboard appears blank and widgets will not load. | There may be a problem with your system’s table collation values. | Blank Admin Dashboard |
| The Choose a Domain page is blank in the Client Area. | You have not enabled any domain registration options. | Blank Choose a Domain Page |
| A domain search returns no results and renders a blank page. | The system encountered an incorrect response type. | Blank Domain Search Results |
| The system automation tasks are generating completely blank invoices. | Multiple cron jobs are attempting to run the system cron at the same time. | Blank Invoices |
| You encounter a blank or partially-rendered page. | There is a fatal PHP error, a problem with a module or template, or a problem with ionCube Loader®. | Blank or Partially-Rendered Pages |
| You see a blank page while attempting payment using a payment gateway module. | There are two copies of the same file in the modules/gateway directory. | Blank Payment Gateway Page |
| The primary navigation bar and sidebar menu items do not display correctly. | The language file that contains the text for these menu items is missing, unreadable, or corrupted. | Client Area Title Display Issues |
| Pages in WHMCS are empty or content is missing. | A template file is missing or contains a syntax error. | Empty Pages |
| After applying an update, some WHMCS features do not function normally, display errors, display with poor formatting, or do not display at all. | In most cases, this behavior is due to outdated customized template files. | Feature Issues After Update |
Invalid Access Attempt | You are using the wrong URL to access the WHMCS Admin Area. | Invalid Access Attempt Errors |
| The most recent WHMCS release does not display when you check for available updates. | The page did not refresh, your settings exclude the new version, or your system does not meet the minimum requirements. | New Version Not Appearing |
| Clicking Order Now or following a direct product order link refreshes the page and shows the product selection page again. | There is a problem with the URL or a template is out-of-date. | Order Now Refreshes the Page |
| The uptime or CPU load statistics for a server are not displaying properly. | The server does not use a Linux®-based operating system, the status directory is inaccessible, or required PHP functions are disabled. | Status Monitoring Display Issues |
| When a user attempts to check out from the shopping cart, the system redirects them to the wrong page. | This issue is due to a problem with the customizations in your header template. | User Redirected to Wrong Page |
Store and Shopping Cart
You may encounter the following common issues:
| Error or Issue | Cause | Next Steps |
| Clicking Order Now or following a direct product order link refreshes the page and shows the product selection page again. | There is a problem with the URL or a template is out-of-date. | Order Now Refreshes the Page |
| Shopping cart prices are incorrect. | You enabled the Monthly Pricing Breakdown feature. | Prices Incorrect in Cart |
Captchas
For more information, see Captcha Protection.
You may encounter the following common issues:
| Error or Issue | Cause | Next Steps |
Captcha verification failed. Contact support for more information. | Your captcha method’s settings are too restrictive. | Captcha Verification Failed |
ERROR for site owner: Invalid domain for site key | The Google reCAPTCHA or hCaptcha® site key is not valid (the domain name is not authorized). | Invalid Site Key Errors |
Ordering Domains and the Domain Checker
For common issues with domain searches and ordering domains, see Troubleshooting Domains.
Last modified: 2025 January 30