Configure a custom error page

搜索

上次更新日期： 2021年4月29日 | 也应用至 Communiqué 3, Communiqué 4

Issue

Is there a way to create a custom error page for 404 and 500 errors in CQ3.x or CQ4.x?

Solution

Edit the following config file:/config/delivery/scripting.xml and add your own error handler for status 404 or 500. For example:

Note: Keep the line <error status="*" script="/libs/Errorhandler/status.ecma" type="ecma" /> that exists and put your handler after it.

ESP Script

<errorhandler>
    <error status="*" script="/libs/Errorhandler/status.ecma" type="ecma" />
    <error status="404" script="/path/to/your/script.esp" type="ecma" />
    ...
</errorhandler>

JSP Script

<errorhandler>
    <error status="*" script="/libs/Errorhandler/status.ecma" type="ecma" />
    <error status="404" script="/path/to/your/script.jsp" type="jsp" />
    ...
</errorhandler>

See the Script Handler Reference page.

Note:

Be careful not to name your script starting with numbers in the name (for example, 404.jsp is an invalid name). See here for more info about this issue.
For your error page to be displayed in Internet Explorer and Google Chrome, the number of characters output by the response must exceed 1000. Otherwise, IE and Chrome output their default error page.