From a5a93a85bc9eebb3b7db65b9523af11be489a23c Mon Sep 17 00:00:00 2001
From: Soheab_ <33902984+Soheab@users.noreply.github.com>
Date: Tue, 28 Feb 2023 08:20:00 +0100
Subject: [PATCH] [commands] Document GroupCog.interaction_check

---
 discord/ext/commands/cog.py | 13 +++++++++++++
 docs/ext/commands/api.rst   |  2 +-
 2 files changed, 14 insertions(+), 1 deletion(-)

diff --git a/discord/ext/commands/cog.py b/discord/ext/commands/cog.py
index 11f6a0393..02136bce8 100644
--- a/discord/ext/commands/cog.py
+++ b/discord/ext/commands/cog.py
@@ -50,6 +50,7 @@ from ._types import _BaseCommand, BotT
 if TYPE_CHECKING:
     from typing_extensions import Self
     from discord.abc import Snowflake
+    from discord._types import ClientT
 
     from .bot import BotBase
     from .context import Context
@@ -585,6 +586,18 @@ class Cog(metaclass=CogMeta):
         """
         return True
 
+    @_cog_special_method
+    def interaction_check(self, interaction: discord.Interaction[ClientT], /) -> bool:
+        """A special method that registers as a :func:`discord.app_commands.check`
+        for every app command and subcommand in this cog.
+
+        This function **can** be a coroutine and must take a sole parameter,
+        ``interaction``, to represent the :class:`~discord.Interaction`.
+
+        .. versionadded:: 2.0
+        """
+        return True
+
     @_cog_special_method
     async def cog_command_error(self, ctx: Context[BotT], error: Exception) -> None:
         """|coro|
diff --git a/docs/ext/commands/api.rst b/docs/ext/commands/api.rst
index 6420d2b0d..9bda24f6e 100644
--- a/docs/ext/commands/api.rst
+++ b/docs/ext/commands/api.rst
@@ -256,7 +256,7 @@ GroupCog
 .. attributetable:: discord.ext.commands.GroupCog
 
 .. autoclass:: discord.ext.commands.GroupCog
-    :members:
+    :members: interaction_check
 
 
 CogMeta