Troubleshooting Client Area Template Issues

A blank or partially-rendered page indicates a fatal PHP error that stops execution from being able to continue. There can be many causes for this issue. For example:

• Using PHP code blocks in your system theme template without enabling the Allow Smarty PHP Tags setting in the Security tab at Configuration () > System Settings > General Settings or, prior to WHMCS 8.0, Setup > General Settings.
• A custom or third-party module or hook that is incompatible with the new version.
• A syntax issue in your system theme template.
• Using Smarty features that the upstream Smarty package has removed.

For more information, see Blank or Partially Rendered Pages.

If you have upgraded your installation and your custom system theme template is no longer working, try the process below.

Check the Logs

Check the Activity Log at Configuration () > System Logs or, prior to WHMCS 8.0, Utilities > Logs > Activity Log. This logs all of the errors that the Smarty templating engine encounters. You can use this to find the exact system theme template and section of code that is causing the problem.

Try a Different System Theme Template

If you don't find anything in the activity logs, switching to a different system theme template will help determine the cause of the issue.

• If changing to a different system theme template allows the client area to load successfully, the issue is in your system theme template itself.
• If you continue to experience problems loading the client area with other system theme templates, then your issue is more likely related to a module or hook and not a specific individual system theme template.

To change the system theme template that your WHMCS system uses, use the System Theme setting in the General tab at Configuration () > System Settings > General Settings or, prior to WHMCS 8.0, Setup > General Settings. Then, click Save and attempt to visit your Client Area.

Check Your System Theme Templates for Legacy Smarty Functions

Most custom system theme templates won't need any updates to be compatible with newer versions of Smarty. However, you must migrate features that are only available in Smarty 2 to ensure a smooth transition to the latest version.

For more information, see our Version 6 Template Migration Guide.

Contact our Support Team

For additional assistance, contact our support team.