diff --git a/docs/api.md b/docs/api.md
index e5dceb3..d7214dd 100644
--- a/docs/api.md
+++ b/docs/api.md
@@ -653,6 +653,9 @@ def click_handler(event):
     them.
     """
     display("I've been clicked!")
+
+### Or manually setting handler without a decorator
+when("click", "#my-button", handler=click_handler)
 ```
 
 This functionality is related to the `py-*` or `mpy-*` [HTML attributes](#html-attributes).