Blank or Partially Rendered Pages
If at any time you encounter a blank page in the WHMCS system then this indicates a fatal PHP error is occurring. This page explains the common causes of such problems, how to identify and subsequently resolve them.
Error reporting is disabled by default.
Having error display enabled while your installation is accessible to end users can lead to potential security risks due to the information error messages often contain. If you enable error reporting for debugging purposes, don't forget to turn it off again!
Template:Enabling Error Reporting
Common Causes
We have collected some of the most most common causes of blank or partially rendered pages along with help and advice below.
Client Area Only
If the admin area is loading correctly and only the client area is blank this suggests the template folder missing or the /templates_c folder invalid path/not writeable.
To resolve this:
- Re-select template under Setup > General Settings and clicking Save Changes.
- Ensure the templates_c has the appropriate permissions/CHMOD and ownership values so it's writeable by the script (usually CHMOD 777).
- If the /templates_c directory has been moved to a custom location ensure the path is correct in the configuration.php file. Your server admin/hosting provider will be able to confirm this.
Admin Login Page Only
The admin login page does not involve templates, so seeing a blank page here suggests a problem with the Ioncube configuration on your server. You can download the Ioncube Loader Wizard from http://www.ioncube.com/loaders.php and upload to your whmcs directory, then visit it in your browser. Your server admin/hosting provider will need to resolve any errors it identifies.
If it reports Ioncube is installed correctly please ensure display_errors is enabled in the server's PHP configuration as this may be suppressing out error messages WHMCS is trying to output with the display_errors line in the configuration.php file detailed above.
Problematic custom widgets may also cause a blank page. Try removing any non-standard files from the /modules/widgets directory.
Blank Pages Elsewhere
If blank pages are occurring on all pages, please try all the above steps, particularly enabling display_errors. If none of the above resolves the issue review any custom files in the following locations and ensure there are no blank spaces or carriage returns outside the <?php and ?> tags:
- /configuration.php
- /includes/hooks/
- /modules/admin/
- /modules/addons/
- /modules/registrars/
- /modules/servers/
- /modules/widgets/
- /lang/
- /lang/overrides/
- /admin/lang/
- /admin/lang/overrides/
It may be necessary to remove any custom files from these locations temporarily, if doing so resolves the issue then you can add them back one-by-one until the problem re-occurs, you can then contact the vendor of the offending file for a fix.
If none of the steps on this page fix the problem then please contact our support team for assistance. In your support ticket please include the attempts you have made to resolve the issue, instructions to reproduce the blank page and FTP/SFTP access.