HOWTO: Customize the Error Pages - JSF UI

Updated: June 19, 2024

JSF UI Deprecation
This requires to have the JSF UI addon installed on your server that is deprecated since Nuxeo Platform LTS 2019.
Please refer to the Web UI documentation.

There are three error pages in the Nuxeo Platform, each of them can be customized:

  • nuxeo_error.jsp: This is the default error page
  • nuxeo_error_security.jsp: It is displayed when a SecurityException is thrown
  • page_not_found.jsp: It is displayed for an error 404

When the server is deployed, all theses pages are located at server/default/deploy/nuxeo.ear/nuxeo.war/. In the source code, these pages are located at nuxeo-platform-webapp/src/main/resources/nuxeo.war/.

You have to override this nuxeo_error.jsp page in a custom project.

  1. Copy this page inside your custom project in the same relative location as it is in the original Nuxeo sources, that is in a comparable nuxeo.war directory.
  2. Update the parts of the pages you want to customize.
  3. The deployment-fragment.xml of your custom project should contain the following requirement to nicely deploy your customized version of the error pages.