diff --git a/discord/utils.py b/discord/utils.py
index efab59087..39e097d5d 100644
--- a/discord/utils.py
+++ b/discord/utils.py
@@ -533,6 +533,12 @@ def escape_mentions(text):
 
         This does not include channel mentions.
 
+    .. note::
+
+        For more granular control over what mentions should be escaped
+        within messages, refer to the :class:`~discord.AllowedMentions`
+        class.
+
     Parameters
     -----------
     text: :class:`str`