How to customize the Page Not Found (404) page

Platform Notice: Data Center Only - This article only applies to Atlassian products on the Data Center platform.

Note that this KB was created for the Data Center version of the product. Data Center KBs for non-Data-Center-specific features may also work for Server versions of the product, however they have not been tested. Support for Server* products ended on February 15th 2024. If you are running a Server product, you can visit the Atlassian Server end of support announcement to review your migration options.

*Except Fisheye and Crucible

Summary

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.

To customize the 404 error page served by Fisheye/Crucible, in order to better fit the design of your site.

Solution

  1. Navigate to the following path on Fisheye/Crucible Server.

    1 <fisheye-install>/content/WEB-INF/web.xml
  2. Edit the <error-page> tag and modify it as follows:

    1 2 3 4 <error-page> <error-code>404</error-code> <location>/404.html</location> </error-page>
  3. Create a new file 404.html under <fisheye-install>/content/. We can use any HTML script like following to modify the custom page.

    1 2 3 4 5 6 7 8 <!DOCTYPE html> <html> <body> <p>Modified 404 page</p> </body> </html>

    Restart Fisheye/Crucible.

Updated on April 2, 2025

Still need help?

The Atlassian Community is here for you.