Application Commands

This section documents everything related to Discord’s application commands.

Discord Models

APISlashCommand

Attributes
Methods
class disnake.APISlashCommand[source]

A slash command returned by the API.

New in version 2.4.

name

The slash command’s name.

Type:

str

name_localizations

Localizations for name.

New in version 2.5.

Type:

LocalizationValue

description

The slash command’s description.

Type:

str

description_localizations

Localizations for description.

New in version 2.5.

Type:

LocalizationValue

nsfw

Whether this command is age-restricted.

New in version 2.8.

Type:

bool

install_types

The installation types where the command is available. Defaults to ApplicationInstallTypes.guild only. Only available for global commands.

New in version 2.10.

Type:

ApplicationInstallTypes | None

contexts

The interaction contexts where the command can be used. Only available for global commands.

New in version 2.10.

Type:

InteractionContextTypes | None

id

The slash command’s ID.

Type:

int

options

The list of options the slash command has.

Type:

list[Option]

application_id

The application ID this command belongs to.

Type:

int

guild_id

The ID of the guild this slash command is enabled in, or None if it’s global.

Type:

int | None

version

Autoincrementing version identifier updated during substantial record changes.

Type:

int

add_option(name, description=None, type=None, required=False, choices=None, options=None, channel_types=None, autocomplete=False, min_value=None, max_value=None, min_length=None, max_length=None)[source]

Adds an option to the current list of options, parameters are the same as for Option

property default_member_permissions[source]

The default required member permissions for this command. A member must have all these permissions to be able to invoke the command in a guild.

This is a default value, the set of users/roles that may invoke this command can be overridden by moderators on a guild-specific basis, disregarding this setting.

If None is returned, it means everyone can use the command by default. If an empty Permissions object is returned (that is, all permissions set to False), this means no one can use the command.

New in version 2.5.

Type:

Permissions | None

property dm_permission[source]

Whether this command can be used in DMs with the bot.

New in version 2.5.

Deprecated since version 2.10: Use contexts instead. This is equivalent to the InteractionContextTypes.bot_dm flag.

APIUserCommand

Attributes
class disnake.APIUserCommand[source]

A user context menu command returned by the API.

New in version 2.4.

name

The user command’s name.

Type:

str

name_localizations

Localizations for name.

New in version 2.5.

Type:

LocalizationValue

nsfw

Whether this command is age-restricted.

New in version 2.8.

Type:

bool

install_types

The installation types where the command is available. Defaults to ApplicationInstallTypes.guild only. Only available for global commands.

New in version 2.10.

Type:

ApplicationInstallTypes | None

contexts

The interaction contexts where the command can be used. Only available for global commands.

New in version 2.10.

Type:

InteractionContextTypes | None

id

The user command’s ID.

Type:

int

application_id

The application ID this command belongs to.

Type:

int

guild_id

The ID of the guild this user command is enabled in, or None if it’s global.

Type:

int | None

version

Autoincrementing version identifier updated during substantial record changes.

Type:

int

property default_member_permissions[source]

The default required member permissions for this command. A member must have all these permissions to be able to invoke the command in a guild.

This is a default value, the set of users/roles that may invoke this command can be overridden by moderators on a guild-specific basis, disregarding this setting.

If None is returned, it means everyone can use the command by default. If an empty Permissions object is returned (that is, all permissions set to False), this means no one can use the command.

New in version 2.5.

Type:

Permissions | None

property dm_permission[source]

Whether this command can be used in DMs with the bot.

New in version 2.5.

Deprecated since version 2.10: Use contexts instead. This is equivalent to the InteractionContextTypes.bot_dm flag.

APIMessageCommand

Attributes
class disnake.APIMessageCommand[source]

A message context menu command returned by the API.

New in version 2.4.

name

The message command’s name.

Type:

str

name_localizations

Localizations for name.

New in version 2.5.

Type:

LocalizationValue

nsfw

Whether this command is age-restricted.

New in version 2.8.

Type:

bool

install_types

The installation types where the command is available. Defaults to ApplicationInstallTypes.guild only. Only available for global commands.

New in version 2.10.

Type:

ApplicationInstallTypes | None

contexts

The interaction contexts where the command can be used. Only available for global commands.

New in version 2.10.

Type:

InteractionContextTypes | None

id

The message command’s ID.

Type:

int

application_id

The application ID this command belongs to.

Type:

int

guild_id

The ID of the guild this message command is enabled in, or None if it’s global.

Type:

int | None

version

Autoincrementing version identifier updated during substantial record changes.

Type:

int

property default_member_permissions[source]

The default required member permissions for this command. A member must have all these permissions to be able to invoke the command in a guild.

This is a default value, the set of users/roles that may invoke this command can be overridden by moderators on a guild-specific basis, disregarding this setting.

If None is returned, it means everyone can use the command by default. If an empty Permissions object is returned (that is, all permissions set to False), this means no one can use the command.

New in version 2.5.

Type:

Permissions | None

property dm_permission[source]

Whether this command can be used in DMs with the bot.

New in version 2.5.

Deprecated since version 2.10: Use contexts instead. This is equivalent to the InteractionContextTypes.bot_dm flag.

ApplicationCommandPermissions

Attributes
Methods
class disnake.ApplicationCommandPermissions[source]

Represents application command permissions for a role, user, or channel.

id

The ID of the role, user, or channel.

Type:

int

type

The type of the target.

Type:

ApplicationCommandPermissionType

permission

Whether to allow or deny the access to the application command.

Type:

bool

is_everyone()[source]

Whether this permission object is affecting the @everyone role.

New in version 2.5.

Return type:

bool

is_all_channels()[source]

Whether this permission object is affecting all channels.

New in version 2.5.

Return type:

bool

GuildApplicationCommandPermissions

Attributes
class disnake.GuildApplicationCommandPermissions[source]

Represents application command permissions in a guild.

Changed in version 2.5: Can now also represent application-wide permissions that apply to every command by default.

id

The application command’s ID, or the application ID if these are application-wide permissions.

Type:

int

application_id

The application ID this command belongs to.

Type:

int

guild_id

The ID of the guild where these permissions are applied.

Type:

int

permissions

A list of ApplicationCommandPermissions.

Type:

list[ApplicationCommandPermissions]

Data Classes

ApplicationCommand

Attributes
class disnake.ApplicationCommand[source]

The base class for application commands.

The following classes implement this ABC:

type

The command type

Type:

ApplicationCommandType

name

The command name

Type:

str

name_localizations

Localizations for name.

New in version 2.5.

Type:

LocalizationValue

nsfw

Whether this command is age-restricted. Defaults to False.

New in version 2.8.

Type:

bool

install_types

The installation types where the command is available. Defaults to ApplicationInstallTypes.guild only. Only available for global commands.

New in version 2.10.

Type:

ApplicationInstallTypes | None

contexts

The interaction contexts where the command can be used. Only available for global commands.

New in version 2.10.

Type:

InteractionContextTypes | None

property default_member_permissions[source]

The default required member permissions for this command. A member must have all these permissions to be able to invoke the command in a guild.

This is a default value, the set of users/roles that may invoke this command can be overridden by moderators on a guild-specific basis, disregarding this setting.

If None is returned, it means everyone can use the command by default. If an empty Permissions object is returned (that is, all permissions set to False), this means no one can use the command.

New in version 2.5.

Type:

Permissions | None

property dm_permission[source]

Whether this command can be used in DMs with the bot.

New in version 2.5.

Deprecated since version 2.10: Use contexts instead. This is equivalent to the InteractionContextTypes.bot_dm flag.

SlashCommand

Attributes
Methods
class disnake.SlashCommand[source]

The base class for building slash commands.

name

The slash command’s name.

Type:

str

name_localizations

Localizations for name.

New in version 2.5.

Type:

LocalizationValue

description

The slash command’s description.

Type:

str

description_localizations

Localizations for description.

New in version 2.5.

Type:

LocalizationValue

nsfw

Whether this command is age-restricted. Defaults to False.

New in version 2.8.

Type:

bool

install_types

The installation types where the command is available. Defaults to ApplicationInstallTypes.guild only. Only available for global commands.

New in version 2.10.

Type:

ApplicationInstallTypes | None

contexts

The interaction contexts where the command can be used. Only available for global commands.

New in version 2.10.

Type:

InteractionContextTypes | None

options

The list of options the slash command has.

Type:

list[Option]

add_option(name, description=None, type=None, required=False, choices=None, options=None, channel_types=None, autocomplete=False, min_value=None, max_value=None, min_length=None, max_length=None)[source]

Adds an option to the current list of options, parameters are the same as for Option

property default_member_permissions[source]

The default required member permissions for this command. A member must have all these permissions to be able to invoke the command in a guild.

This is a default value, the set of users/roles that may invoke this command can be overridden by moderators on a guild-specific basis, disregarding this setting.

If None is returned, it means everyone can use the command by default. If an empty Permissions object is returned (that is, all permissions set to False), this means no one can use the command.

New in version 2.5.

Type:

Permissions | None

property dm_permission[source]

Whether this command can be used in DMs with the bot.

New in version 2.5.

Deprecated since version 2.10: Use contexts instead. This is equivalent to the InteractionContextTypes.bot_dm flag.

UserCommand

Attributes
class disnake.UserCommand[source]

A user context menu command.

name

The user command’s name.

Type:

str

name_localizations

Localizations for name.

New in version 2.5.

Type:

LocalizationValue

nsfw

Whether this command is age-restricted. Defaults to False.

New in version 2.8.

Type:

bool

install_types

The installation types where the command is available. Defaults to ApplicationInstallTypes.guild only. Only available for global commands.

New in version 2.10.

Type:

ApplicationInstallTypes | None

contexts

The interaction contexts where the command can be used. Only available for global commands.

New in version 2.10.

Type:

InteractionContextTypes | None

property default_member_permissions[source]

The default required member permissions for this command. A member must have all these permissions to be able to invoke the command in a guild.

This is a default value, the set of users/roles that may invoke this command can be overridden by moderators on a guild-specific basis, disregarding this setting.

If None is returned, it means everyone can use the command by default. If an empty Permissions object is returned (that is, all permissions set to False), this means no one can use the command.

New in version 2.5.

Type:

Permissions | None

property dm_permission[source]

Whether this command can be used in DMs with the bot.

New in version 2.5.

Deprecated since version 2.10: Use contexts instead. This is equivalent to the InteractionContextTypes.bot_dm flag.

MessageCommand

Attributes
class disnake.MessageCommand[source]

A message context menu command

name

The message command’s name.

Type:

str

name_localizations

Localizations for name.

New in version 2.5.

Type:

LocalizationValue

nsfw

Whether this command is age-restricted. Defaults to False.

New in version 2.8.

Type:

bool

install_types

The installation types where the command is available. Defaults to ApplicationInstallTypes.guild only. Only available for global commands.

New in version 2.10.

Type:

ApplicationInstallTypes | None

contexts

The interaction contexts where the command can be used. Only available for global commands.

New in version 2.10.

Type:

InteractionContextTypes | None

property default_member_permissions[source]

The default required member permissions for this command. A member must have all these permissions to be able to invoke the command in a guild.

This is a default value, the set of users/roles that may invoke this command can be overridden by moderators on a guild-specific basis, disregarding this setting.

If None is returned, it means everyone can use the command by default. If an empty Permissions object is returned (that is, all permissions set to False), this means no one can use the command.

New in version 2.5.

Type:

Permissions | None

property dm_permission[source]

Whether this command can be used in DMs with the bot.

New in version 2.5.

Deprecated since version 2.10: Use contexts instead. This is equivalent to the InteractionContextTypes.bot_dm flag.

Option

Attributes
Methods
class disnake.Option(name, description=None, type=None, required=False, choices=None, options=None, channel_types=None, autocomplete=False, min_value=None, max_value=None, min_length=None, max_length=None)[source]

Represents a slash command option.

Parameters:

  • name (str | Localized) –

    The option’s name.

    Changed in version 2.5: Added support for localizations.

  • description (str | Localized | None) –

    The option’s description.

    Changed in version 2.5: Added support for localizations.

  • type (OptionType) – The option type, e.g. OptionType.user.

  • required (bool) – Whether this option is required.

  • choices (Sequence[OptionChoice] | Sequence[str | int | float] | Mapping[str, str | int | float]) – The pre-defined choices for this option.

  • options (list[Option]) – The list of sub options. Normally you don’t have to specify it directly, instead consider using @main_cmd.sub_command or @main_cmd.sub_command_group decorators.

  • channel_types (list[ChannelType]) – The list of channel types that your option supports, if the type is OptionType.channel. By default, it supports all channel types.

  • autocomplete (bool) – Whether this option can be autocompleted.

  • min_value (int | float) – The minimum value permitted.

  • max_value (int | float) – The maximum value permitted.

  • min_length (int) –

    The minimum length for this option if this is a string option.

    New in version 2.6.

  • max_length (int) –

    The maximum length for this option if this is a string option.

    New in version 2.6.

name

The option’s name.

Type:

str

description

The option’s description.

Type:

str

type

The option type, e.g. OptionType.user.

Type:

OptionType

required

Whether this option is required.

Type:

bool

choices

The list of pre-defined choices.

Type:

list[OptionChoice]

options

The list of sub options. Normally you don’t have to specify it directly, instead consider using @main_cmd.sub_command or @main_cmd.sub_command_group decorators.

Type:

list[Option]

channel_types

The list of channel types that your option supports, if the type is OptionType.channel. By default, it supports all channel types.

Type:

list[ChannelType]

autocomplete

Whether this option can be autocompleted.

Type:

bool

min_value

The minimum value permitted.

Type:

int | float

max_value

The maximum value permitted.

Type:

int | float

min_length

The minimum length for this option if this is a string option.

New in version 2.6.

Type:

int

max_length

The maximum length for this option if this is a string option.

New in version 2.6.

Type:

int

add_choice(name, value)[source]

Adds an OptionChoice to the list of current choices, parameters are the same as for OptionChoice.

add_option(name, description=None, type=None, required=False, choices=None, options=None, channel_types=None, autocomplete=False, min_value=None, max_value=None, min_length=None, max_length=None)[source]

Adds an option to the current list of options, parameters are the same as for Option.

OptionChoice

class disnake.OptionChoice[source]

Represents an option choice.

Parameters:

  • name (str | Localized) –

    The name of the option choice (visible to users).

    Changed in version 2.5: Added support for localizations.

  • value (str | int) – The value of the option choice.

ApplicationInstallTypes

Attributes
Methods
class disnake.ApplicationInstallTypes[source]

Represents the location(s) in which an application or application command can be installed.

See the official documentation for more info.

x == y

Checks if two ApplicationInstallTypes instances are equal.

x != y

Checks if two ApplicationInstallTypes instances are not equal.

x <= y

Checks if an ApplicationInstallTypes instance is a subset of another ApplicationInstallTypes instance.

x >= y

Checks if an ApplicationInstallTypes instance is a superset of another ApplicationInstallTypes instance.

x < y

Checks if an ApplicationInstallTypes instance is a strict subset of another ApplicationInstallTypes instance.

x > y

Checks if an ApplicationInstallTypes instance is a strict superset of another ApplicationInstallTypes instance.

x | y, x |= y

Returns a new ApplicationInstallTypes instance with all enabled flags from both x and y. (Using |= will update in place).

x & y, x &= y

Returns a new ApplicationInstallTypes instance with only flags enabled on both x and y. (Using &= will update in place).

x ^ y, x ^= y

Returns a new ApplicationInstallTypes instance with only flags enabled on one of x or y, but not both. (Using ^= will update in place).

~x

Returns a new ApplicationInstallTypes instance with all flags from x inverted.

hash(x)

Returns the flag’s hash.

iter(x)

Returns an iterator of (name, value) pairs. This allows it to be, for example, constructed as a dict or a list of pairs. Note that aliases are not shown.

Additionally supported are a few operations on class attributes.

ApplicationInstallTypes.y | ApplicationInstallTypes.z, ApplicationInstallTypes(y=True) | ApplicationInstallTypes.z

Returns an ApplicationInstallTypes instance with all provided flags enabled.

~ApplicationInstallTypes.y

Returns an ApplicationInstallTypes instance with all flags except y inverted from their default value.

New in version 2.10.

value

The raw value. You should query flags via the properties rather than using this raw value.

Type:

int

classmethod all()[source]

A factory method that creates an ApplicationInstallTypes instance with everything enabled.

guild

Returns True if installable to guilds.

Type:

bool

user

Returns True if installable to users.

Type:

bool

InteractionContextTypes

Attributes
Methods
class disnake.InteractionContextTypes[source]

Represents the context(s) in which an application command can be used.

See the official documentation for more info.

x == y

Checks if two InteractionContextTypes instances are equal.

x != y

Checks if two InteractionContextTypes instances are not equal.

x <= y

Checks if an InteractionContextTypes instance is a subset of another InteractionContextTypes instance.

x >= y

Checks if an InteractionContextTypes instance is a superset of another InteractionContextTypes instance.

x < y

Checks if an InteractionContextTypes instance is a strict subset of another InteractionContextTypes instance.

x > y

Checks if an InteractionContextTypes instance is a strict superset of another InteractionContextTypes instance.

x | y, x |= y

Returns a new InteractionContextTypes instance with all enabled flags from both x and y. (Using |= will update in place).

x & y, x &= y

Returns a new InteractionContextTypes instance with only flags enabled on both x and y. (Using &= will update in place).

x ^ y, x ^= y

Returns a new InteractionContextTypes instance with only flags enabled on one of x or y, but not both. (Using ^= will update in place).

~x

Returns a new InteractionContextTypes instance with all flags from x inverted.

hash(x)

Returns the flag’s hash.

iter(x)

Returns an iterator of (name, value) pairs. This allows it to be, for example, constructed as a dict or a list of pairs. Note that aliases are not shown.

Additionally supported are a few operations on class attributes.

InteractionContextTypes.y | InteractionContextTypes.z, InteractionContextTypes(y=True) | InteractionContextTypes.z

Returns an InteractionContextTypes instance with all provided flags enabled.

~InteractionContextTypes.y

Returns an InteractionContextTypes instance with all flags except y inverted from their default value.

New in version 2.10.

value

The raw value. You should query flags via the properties rather than using this raw value.

Type:

int

classmethod all()[source]

A factory method that creates an InteractionContextTypes instance with everything enabled.

guild

Returns True if the command is usable in guilds.

Type:

bool

bot_dm

Returns True if the command is usable in DMs with the bot.

Type:

bool

private_channel

Returns True if the command is usable in DMs and group DMs with other users.

Type:

bool

Enumerations

OptionType

class disnake.OptionType[source]

Represents the type of an option.

New in version 2.1.

sub_command

Represents a sub command of the main command or group.

sub_command_group

Represents a sub command group of the main command.

string

Represents a string option.

integer

Represents an integer option.

boolean

Represents a boolean option.

user

Represents a user option.

channel

Represents a channel option.

role

Represents a role option.

mentionable

Represents a role + user option.

number

Represents a float option.

attachment

Represents an attachment option.

New in version 2.4.

ApplicationCommandType

class disnake.ApplicationCommandType[source]

Represents the type of an application command.

New in version 2.1.

chat_input

Represents a slash command.

user

Represents a user command from the context menu.

message

Represents a message command from the context menu.

ApplicationCommandPermissionType

class disnake.ApplicationCommandPermissionType[source]

Represents the type of a permission of an application command.

New in version 2.5.

role

Represents a permission that affects roles.

user

Represents a permission that affects users.

channel

Represents a permission that affects channels.

Events