diff --git a/doc/new-guidelines.md b/doc/new-guidelines.md
index 2aae5f80af..c90de39a7c 100644
--- a/doc/new-guidelines.md
+++ b/doc/new-guidelines.md
@@ -467,9 +467,9 @@ Prefer the pure version of `:json-rpc/call` (no callbacks).
 
 ### Registering event handlers
 
-Register events with `re-frame.core/reg-event-fx` and follow [re-frame's best
+Register events with `utils.re-frame/reg-event-fx` and follow [re-frame's best
 practice](https://github.com/day8/re-frame/blob/39adca93673f334dc751ee2d99d340b51a9cc6db/docs/FAQs/BestPractice.md#use-the-fx-effect)
-so use only `:db` and `:fx` effects. `rf/merge` is deprecated and should not be
+so use only `:db` and `:fx` effects. `utils.re-frame/merge` and `utils.re-frame/defn` are deprecated and should not be
 used in the new code in `src/status_im2/`. Don't use
 `re-frame.core/reg-event-db`.
 
diff --git a/src/utils/re_frame.clj b/src/utils/re_frame.clj
index 032ea84d63..852a22a932 100644
--- a/src/utils/re_frame.clj
+++ b/src/utils/re_frame.clj
@@ -28,7 +28,9 @@
   event keywords under which the function will be registered
   - TODO: add suport for `prepost-map?` (don't forget to add it to arglist)
   - TODO: add validation of macro parameters"
-  {:arglists '([name doc-string? attr-map? [params*] body])}
+  {:arglists      '([name doc-string? attr-map? [params*] body])
+   :deprecated    true
+   :superseded-by "utils.re-frame/reg-event-fx"}
   [name & fdecl]
   (let [m             (if (string? (first fdecl))
                         {:doc (first fdecl)}