diff --git a/src/reference/actions.xml b/src/reference/actions.xml
index 458b3908..67ccb1af 100644
--- a/src/reference/actions.xml
+++ b/src/reference/actions.xml
@@ -237,6 +237,19 @@ public Event makeBooking(RequestContext context) {
}]]>
+
+ Using an exception-handler element
+
+ In general it is recommended to catch exceptions in actions and return result
+ events that drive standard transitions, it is also possible to add an
+ exception-handler sub-element to any state type with a
+ bean attribute referencing a bean of type
+ FlowExecutionExceptionHandler. This is an advanced
+ option that if used incorrectly can leave the flow execution in an invalid state.
+ Consider the build-in TransitionExecutingFlowExecutionExceptionHandler
+ as example of a correct implementation.
+
+
Other Action execution examples