diff --git a/discord/ext/commands/cog.py b/discord/ext/commands/cog.py
index b8e259177..a36e3f1dc 100644
--- a/discord/ext/commands/cog.py
+++ b/discord/ext/commands/cog.py
@@ -296,6 +296,10 @@ class Cog(metaclass=CogMeta):
         """A special method that registers as a :meth:`.Bot.check_once`
         check.
 
+        Note that when using this function, context sent from a group command
+        may only parse the parent command and not the subcommands due to it
+        being invoked once per :meth:`.Command.invoke` call.
+
         This function **can** be a coroutine and must take a sole parameter,
         ``ctx``, to represent the :class:`.Context`.
         """