diff --git a/CHANGES b/CHANGES
index 63c8c6f7ce..68617a4418 100644
--- a/CHANGES
+++ b/CHANGES
@@ -12,6 +12,12 @@
--- Functionality changes from Asterisk 15 to Asterisk 16 --------------------
------------------------------------------------------------------------------
+app_macro
+------------------
+ * The app_macro module is now deprecated and by default it is no longer
+ built. Users should migrate to app_stack (Gosub). A warning is logged
+ the first time any Macro is used.
+
chan_sip
------------------
* New function SIP_HEADERS() enumerates all headers in the incoming INVITE.
diff --git a/UPGRADE.txt b/UPGRADE.txt
index 1fe82c04ea..39c0f8cec8 100644
--- a/UPGRADE.txt
+++ b/UPGRADE.txt
@@ -26,6 +26,11 @@
New in 16.0.0:
+app_macro:
+ - The app_macro module is now deprecated and by default it is no longer
+ built. Users should migrate to app_stack (Gosub). A warning is logged
+ the first time any Macro is used.
+
New in 15.0.0:
Build System:
diff --git a/apps/app_dial.c b/apps/app_dial.c
index 847a095f44..8c51f3f1a4 100644
--- a/apps/app_dial.c
+++ b/apps/app_dial.c
@@ -324,6 +324,10 @@
Be aware of the limitations that macros have, specifically with regards to use of
the WaitExten application. For more information, see the documentation for
Macro().
+
+ Macros are deprecated, GoSub should be used instead,
+ see the U option.
+