Our Help Portal

Troubleshooting Support Articles
Searchable Help Information Repository
Self-Service Resources How-Tos
Technical Customer Walkthroughs   Browse All Knowledge ! ....

Get Prices Learn More


< All Topics

How to customize the 404 page in WHMCS?

Customizing the 404 error page in WHMCS involves making adjustments to the template files. Follow these steps to create a personalized 404 error page:

  1. Access WHMCS Files:
    • Connect to your server using FTP or a file manager provided by your hosting control panel.
    • Navigate to the root directory where WHMCS is installed.
  2. Locate the Template Files:
    • Go to the “templates” folder within the WHMCS directory.
  3. Identify the Active Theme:
    • Inside the “templates” folder, you will find subdirectories corresponding to different themes. Identify the active theme your WHMCS installation is using (e.g., “six,” “default”).
  4. Edit the Header and Footer Files:
    • Inside the active theme folder, look for files named “header.tpl” and “footer.tpl.”
    • Open these files using a text editor (e.g., Notepad++, Sublime Text).
  5. Insert Custom 404 Content:
    • Within “header.tpl,” locate the <body> tag.
    • Add HTML code to create your custom 404 page. You might want to include a message, a search bar, or links to key pages.
    • Save the changes to “header.tpl.”
  6. Update the Footer:
    • In “footer.tpl,” locate the closing </body> and </html> tags.
    • Insert any additional content or scripts required for your custom 404 page.
    • Save the changes to “footer.tpl.”
  7. Test the Custom 404 Page:
    • After saving the changes, clear your browser cache and navigate to a non-existent page on your WHMCS site to test the custom 404 error page.
  8. Additional Considerations:
    • You may need to customize CSS styles within the stylesheet associated with your theme to ensure a cohesive look for your custom 404 page.
    • Always make backups of files before making changes, and test your changes on a staging environment if possible.

By following these steps, you can create a customized 404 error page in WHMCS that aligns with your branding and provides useful information to users who encounter a page not found error.