diff --git a/cylc/flow/xtriggers/echo.py b/cylc/flow/xtriggers/echo.py
index 2e964156b83..ec7aa63f3c4 100644
--- a/cylc/flow/xtriggers/echo.py
+++ b/cylc/flow/xtriggers/echo.py
@@ -34,7 +34,9 @@ def echo(*args, **kwargs) -> Tuple:
     Examples:
 
         >>> echo('Breakfast Time', succeed=True, egg='poached')
-        True, {'succeed': True, 'egg': 'poached'}
+        echo: ARGS: ('Breakfast Time',)
+        echo: KWARGS: {'succeed': True, 'egg': 'poached'}
+        (True, {'succeed': True, 'egg': 'poached'})
 
     Returns
         (True/False, kwargs)