How to customize the Page Not Found (404) page
The content on this page includes steps to customize or extend Atlassian software (adding/changing CSS rules, HTML, JavaScript, etc.). Per the Atlassian Support Offerings, support does not include customizations made to Atlassian products. Be aware that this material is provided for your information only and using it is done so at your risk.
If you have any questions about this or any customization, please ask the community at Atlassian Answers or consider working with an Atlassian Solution Partner.
Purpose
To customize the 404 error page served by Crowd, in order to better fit the design of your site.
Solution
Navigate to the following path on Crowd Server.
<crowd-install>/crowd-webapp/WEB-INF/web.xmlAdd the following snippet at the bottom of the page, but before the </web-app> tag.
<error-page> <error-code>404</error-code> <location>/404.html</location> </error-page>Create a new file
404.htmlunder<crowd-install>/crowd-webapp/. We can use any HTML script like following to modify the custom page.<!DOCTYPE html> <html> <body> <p>Modified 404 page</p> </body> </html>Restart Crowd.
Even though the filename needs to be 404.html the content on it can be whatever you would like to place in there. Thus, if you wanted to have the page be blank with no content or redirect to something else, you could set up the document accordingly to render. If you wanted to return a specific HTTP error code, this is not possible in the platform to route 404 pages to return HTTP 500 requests.