Command Groups

Command groups are a way to create subcommands for your commands. For example, !afk set or !afk remove.

Syntax

Creating a command group is very simple.

Command Groups Example
import discord
from discord.ext import commands

bot = commands.Bot(command_prefix='!')

@bot.group()
async def afk():
    pass

@afk.command()
async def set():
    ...

@afk.command()
async def remove():
    ...

# Another command group

@bot.group(invoke_without_command=True) # Indicates if the group callback should begin parsing and invocation only if no subcommand was found.
async def math(ctx):
    await ctx.send('Subcommand not found')

@math.command()
async def add(ctx, a: int, b: int):
    ...

@math.command()
async def subtract(ctx, a: int, b: int):
    ...

To create a command group, the command's decorator must be @bot.group. Once you have a command with that decorator, you can use @function.command(), such as @math.command(). Now, you have subcommand groups!

Syntax​

Syntax