Our documentation is getting an overhaul! We would like your input! Click here to take a look at the beta launch of our new documentation site! Only cPanel & WHM version 82 documentation exists on our beta at this time. 84 will be added to the new site soon! Leave your feedback here: https://go.cpanel.net/docsfeedback
The failurls File - Version 72 Documentation - cPanel Documentation
Page tree
For cPanel & WHM version 72
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:  http://example.com/index.php?failed=1  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=" http://example.com/failed.html " /> 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: http://example.com/failed.html  in the failurls file matches the <input type="hidden" name="failurl" value=" http://example.com/failed.html " /> 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