View source for Troubleshooting Client Area Template Issues

You've upgraded your installation, but now your custom client area template is no longer working. The steps below may help you.

==Why does this happen?==

A blank or partially rendered page indicates a fatal PHP error is occurring which stops the execution from being able to continue.  This can be caused by a number of reasons, most commonly:

* Using PHP code blocks in your template without the '''Allow Smarty PHP Tags''' setting enabled at '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > General Settings > Security'''.
* A custom or third party module or hook that is incompatible with the new version
* A syntax issue in your template
* Using features of Smarty that have been removed in the upstream Smarty package

For more detailed information, please see [[Blank or Partially Rendered Pages]].

==Check the Logs==

The first place to check any time you encounter an error of this nature is the [[Activity_Logs|Activity Log]].  This can be acccessed by navigating to '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Logs''' ('''Utilities > Logs > Activity Log''' in WHMCS 7.x and earlier) within the admin area.  All errors encountered by the Smarty templating engine are logged here, and should help pinpoint the exact template and section of code that is causing the problem.

==Try a Different Template==

If you don't find anything in the activity logs, switching to a different template will help determine where the issue lies.

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

To change the template your WHMCS system uses, navigate to '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > General Settings''' and choose one of the default templates in the '''Template''' setting found on the first tab of the settings.  Then, hit '''Save''', and attempt to visit your client area.

==Check Your Templates for Legacy Smarty Functions==

Most custom templates won't need any updates to be compatible with newer versions of Smarty, but those features only available in Smarty 2 will need to be migrated to ensure a smooth transition to the latest version.

For more information on exactly what's changed, please refer to our [[Version 6 Template Migration Guide]].

==Contact our Support Team==

If none of the above help, then you should contact our support team for further assistance.  To do that, visit http://www.whmcs.com/support/ and select the '''Ask Us''' link.
No results found.