This documentation is for cPanel & WHM version 84 CURRENT builds.  The "RELEASE" version of our documentation can be found in the Version 82 Documentation space.

Skip to end of metadata
Go to start of metadata


If a user fails to authenticate with cPanel through a custom login form, the /var/cpanel/failurls file allows a reseller to redirect that user to a custom error page.


Make certain that your entries in the failurls file meet the following requirements:

  • Each entry must be on a separate line.
  • Each entry must be a static URL.
    • For example:  is not a valid entry because it is a dynamic URL.
  • The login page must pass dynamic content via hidden POST variables. GET query strings will fail because they will not match any entry in the failurls file.
    • For example: <input type="hidden" name="failurl" value=" " /> is a valid hidden POST variable.
  • The failurl value in the custom login form must match one of the entries in the failurls file.
    • For example:  in the failurls file matches the <input type="hidden" name="failurl" value=" " /> hidden POST variable.

Restart cPanel

After you create the entries in the failurls file, use the following command as the root user to restart cPanel:


Additional documentation