Skip to content

Exception status codeΒΆ

Available since: 2.1.0

Event that is dispatched when a routing exception 4xx or 5xx is found.

Provided tokens

Token Description
[user] The current user.
Alias: current_user
[htmx] Information about the current HTMX request.
[htmx:is_request] Whether the current request was sent by HTMX ("1" or "0").
[htmx:boosted] Whether the current request was boosted by HTMX ("1" or "0").
[htmx:history_restore] Whether the current request is for HTMX history restoration ("1" or "0").
[htmx:target] The value of the HX-Target request header.
[htmx:trigger] The value of the HX-Trigger request header.
[htmx:trigger_name] The value of the HX-Trigger-Name request header.
[htmx:current_url] The value of the HX-Current-URL request header.
[htmx:prompt] The value of the HX-Prompt request header.
[event] The event.
[event:machine_name] The machine name of the ECA event.
[session_user] The user account that dispatched the event, regardless if ECA is processing models under a different account. This is only available if ECA is configured to always run under a specific account.

Fires when an HTTP exception with a 4xx or 5xx status code is encountered during routing. The [event:code] token provides the HTTP status code.

Useful for redirecting users on specific error codes (e.g., redirect to login on 403, custom page on 404), or sending notifications on server errors.