# Changelog¶

This page keeps a detailed human friendly rendering of what’s new and changed in specific versions.

## v2.5.0¶

This version adds support for API v10 (which comes with a few breaking changes), forum channels, localizations, permissions v2, improves API coverage by adding support for previously missing features like guild previews, widgets, or welcome screens, and contains several miscellaneous enhancements and bugfixes.

Regarding the message content intent: Note that earlier versions will continue working fine after the message content intent deadline (August 31st 2022), as long as the intent is enabled in the developer portal. However, from this version (2.5.0) onward, the intent needs to be enabled in the developer portal and your code. See this page of the guide for more information. If you do not have access to the intent yet, you can temporarily continue using API v9 by calling disnake.http._workaround_set_api_version(9) before connecting, which will keep sending message content before the intent deadline, even with the intent disabled.

### Miscellaneous¶

• Fix remaining pyright issues, add pyright CI (#311, #387, #514)

• Update dev dependencies and CI (#345, #386, #451)

• Improve _WebhookState typing (#391)

• Improve basic_bot.py example (#399)

• Add low-level component example (#452)

• Update Discord server invite links (#476)

## v2.4.0¶

This version contains many new features, including attachment options, modals, and the ability to directly send message components without views, as well as several fixes and other general improvements.

### Breaking Changes¶

• The constructor of and its subtypes no longer accepts **kwargs for setting internal values (#249)
• This shouldn’t affect anyone, as **kwargs was only used for setting fields returned by the API and had no effect if the user set them

• now returns proper permission values in DMs (#321)

• The reason parameter for sticker endpoints in HTTPClient is now kwarg-only

### Deprecations¶

• Thread.archiver_id is not being provided by the API anymore and will be removed in a future version (#295)

• Invite.revoked is not being provided by the API anymore and will be removed in a future version (#309)

### Documentation¶

• Show tooltips when hovering over links (#236, #242)

• Slight redesign and general layout improvements (#278)

### Miscellaneous¶

• Improve examples (#209, #262, #270, #307, #332, #341)

• Improve typing/annotations of several parts of the library (#249, #256, #263, #279, #292, #299, #308)

• Improve member deserialization (#304)

• Split application command objects into separate types for data returned by the API (#299)

## v2.3.2¶

### Bug Fixes¶

• Fix invalid default value for application command option descriptions (#338)

## v2.3.1¶

### Documentation¶

• Fix guild_permissions() documentation

• Fix missing dropdown icon (#235)

### Miscellaneous¶

• Add isort and black pre-commit hooks, run isort (#169, #173, #233)

• Rename tests directory (#232)

## v2.3.0¶

This version contains several new features and fixes, notably support for guild scheduled events, guild timeouts, and a slash command rework with parameter injections, as well as several documentation fixes.

Note: the Version Guarantees have been updated to more accurately reflect the versioning scheme this library is following.

### Breaking Changes¶

• The supported aiohttp version range changed from >=3.6.0,<3.8.0 to >=3.7.0,<3.9.0

• Due to the upcoming text-in-voice feature (not yet released at the time of writing), many methods/properties that previously returned a can now also return a , which shares many but not all of its methods. Also see the details for text-in-voice under “New Features” below, which include a few important things to note.

• Slash command internals have undergone an extensive rework, and while existing code should still work as before, it is recommended that you do some testing using the new implementation first

• may now also return or instances, see documentation

• disnake.types.ThreadArchiveDuration is now ThreadArchiveDurationLiteral, to avoid confusion with the new enum

### Deprecations¶

• The role_ids and user_ids parameters for guild_permissions are now roles and users respectively; the old parameter names will be removed in a future version

### Miscellaneous¶

• Add Python 3.10 to package classifiers (#127)

• Change supported aiohttp version range from >=3.6.0,<3.8.0 to >=3.7.0,<3.9.0 (#119, #164)

• Add guide for configuring inviting a bot through its profile (#153)

• Improve examples (#143)

## v2.2.3¶

### Bug Fixes¶

• Fix invalid default value for application command option descriptions (#338)

## v2.2.1¶

### Bug Fixes¶

• Fixed error related to guild member count

## v2.1.5¶

### New Features¶

• Add UnresolvedGuildApplicationCommandPermissions

• Add kwargs min_value and max_value in

• [ext.commands] Add kwarg min_value (with aliases ge, gt) to

• [ext.commands] Add kwarg max_value (with aliases le, lt) to

• [ext.commands] Add kwarg owner to guild_permissions

### Bug Fixes¶

• Command deletions on reconnections

• Pending sync tasks on loop termination

## v2.1.4¶

### Bug Fixes¶

• Fixed some issues with application command permissions synchronisation

## v2.1.3¶

### New Features¶

• Add PartialGuildApplicationCommandPermissions

• [ext.commands] Add guild_permissions

• [ext.commands] Add kwargs sync_commands_on_cog_unload and sync_permissions to InteractionBotBase

### Bug Fixes¶

• Music

• default_permission kwarg in user / message commands

• Commands no longer sync during the loop termination

## v2.1.2¶

This is the first stable version of this discord.py 2.0 fork.

## v1.7.3¶

### Bug Fixes¶

• Fix a crash involving guild uploaded stickers

## v1.7.0¶

This version is mainly for improvements and bug fixes. This is more than likely the last major version in the 1.x series. Work after this will be spent on v2.0. As a result, this is the last version to support Python 3.5. Likewise, this is the last version to support user bots.

Development of v2.0 will have breaking changes and support for newer API features.

### Miscellaneous¶

• User endpoints and all userbot related functionality has been deprecated and will be removed in the next major version of the library.

• Permission class methods were updated to match the UI of the Discord client (#6476)

• _ and - characters are now stripped when making a new cog using the disnake package (#6313)

## v1.6.0¶

This version comes with support for replies and stickers.

## v1.5.0¶

This version came with forced breaking changes that Discord is requiring all bots to go through on October 7th. It is highly recommended to read the documentation on intents, A Primer to Gateway Intents.

### API Changes¶

• Members and presences will no longer be retrieved due to an API change. See Privileged Intents for more info.

• As a consequence, fetching offline members is disabled if the members intent is not enabled.

### Miscellaneous¶

• Webhook requests are now logged (#5798)

• Remove caching layer from . This was causing issues if queried before launching shards.

• Gateway rate limits are now handled.

• Warnings logged due to missed caches are now changed to DEBUG log level.

• Some strings are now explicitly interned to reduce memory usage.

• Usage of namedtuples has been reduced to avoid potential breaking changes in the future (#5834)

• [ext.commands] All BadArgument exceptions from the built-in converters now raise concrete exceptions to better tell them apart (#5748)

• [ext.tasks] Lazily fetch the event loop to prevent surprises when changing event loop policy (#5808)

## v1.4.2¶

This is a maintenance release with backports from v1.5.0.

## v1.4.1¶

### Bug Fixes¶

• Properly terminate the connection when is called (#5207)

• Fix error being raised when clearing embed author or image when it was already cleared (#5210, #5212)

• Fix __path__ to allow editable extensions (#5213)

## v1.4.0¶

Another version with a long development time. Features like Intents are slated to be released in a v1.5 release. Thank you for your patience!

## v1.3.4¶

### Bug Fixes¶

• Fix an issue with channel overwrites causing multiple issues including crashes (#5109)

## v1.3.3¶

### Bug Fixes¶

• Change default WS close to 4000 instead of 1000.
• The previous close code caused sessions to be invalidated at a higher frequency than desired.

• Fix None appearing in Member.activities. (#2619)

## v1.3.2¶

Another minor bug fix release.

## v1.3.1¶

Minor bug fix release.

### Miscellaneous¶

• Fix compatibility warnings when using the Python 3.9 alpha.

• Change the unknown event logging from WARNING to DEBUG to reduce noise.

## v1.3.0¶

This version comes with a lot of bug fixes and new features. It’s been in development for a lot longer than was anticipated!

### Miscellaneous¶

• The library now fully supports Python 3.8 without warnings.

• Bump the dependency of websockets to 8.0 for those who can use it. (#2453)

• Due to Discord providing data in mentions, users will now be upgraded to more often if mentioned.

• now properly escapes new quote markdown.

• The message cache can now be disabled by passing None to max_messages in .

• The default message cache size has changed from 5000 to 1000 to accommodate small bots.

• Lower memory usage by only creating certain objects as needed in .

• There is now a sleep of 5 seconds before re-IDENTIFYing during a reconnect to prevent long loops of session invalidation.

• The rate limiting code now uses millisecond precision to have more granular rate limit handling.
• Along with that, the rate limiting code now uses Discord’s response to wait. If you need to use the system clock again for whatever reason, consider passing assume_synced_clock in .

• The performance of has been improved from O(N) to O(1). (#2375)

• The performance of has improved due to usage of caching to avoid surprising performance traps.

• The GC is manually triggered during things that cause large deallocations (such as guild removal) to prevent memory fragmentation.

• There have been many changes to the documentation for fixes both for usability, correctness, and to fix some linter errors. Thanks to everyone who contributed to those.

• The loading of the opus module has been delayed which would make the result of somewhat surprising.

• [ext.commands] Usernames prefixed with @ inside DMs will properly convert using the converter. (#2498)

• [ext.tasks] The task sleeping time will now take into consideration the amount of time the task body has taken before sleeping. (#2516)

## v1.2.5¶

### Bug Fixes¶

• Fix a bug that caused crashes due to missing animated field in Emoji structures in reactions.

## v1.2.2¶

### Bug Fixes¶

• Audit log related attribute access have been fixed to not error out when they shouldn’t have.

## v1.2.1¶

### Bug Fixes¶

• User.avatar_url and related attributes no longer raise an error.

• More compatibility shims with the enum.Enum code.

## v1.2.0¶

This update mainly brings performance improvements and various nitro boosting attributes (referred to in the API as “premium guilds”).

### Miscellaneous¶

• Improve performance of all Enum related code significantly.
• This was done by replacing the enum.Enum code with an API compatible one.

• This should not be a breaking change for most users due to duck-typing.

• Improve performance of message creation by about 1.5x.

• Improve performance of message editing by about 1.5-4x depending on payload size.

• Improve performance of attribute access on about by 2x.

• Improve performance of by around 4-6x depending on usage.

• Improve performance of event parsing lookup by around 2.5x.

• Keyword arguments in and are now validated (#953, #2170)

• The Discord error code is now shown in the exception message for .

• Internal tasks launched by the library will now have their own custom __repr__.

• All public facing types should now have a proper and more detailed __repr__.

• [ext.tasks] Errors are now logged via the standard logging module.

## v1.1.1¶

### Bug Fixes¶

• Webhooks do not overwrite data on retrying their HTTP requests (#2140)

## v1.1.0¶

### Bug Fixes¶

#### disnake.ext.commands¶

• Fix lambda converters in a non-module context (e.g. eval).

• Use message creation time for reference time when computing cooldowns.
• This prevents cooldowns from triggering during e.g. a RESUME session.

• Fix the default on_command_error() to work with new-style cogs (#2094)

• DM channels are now recognised as NSFW in check.

• Fix race condition with help commands (#2123)

• Fix cog descriptions not showing in (#2139)

### Miscellaneous¶

• Improve the performance of internal enum creation in the library by about 5x.

• Make the output of python -m disnake --version a bit more useful.

• The loop cleanup facility has been rewritten again.

• The signal handling in has been removed.

#### disnake.ext.commands¶

• Custom exception classes are now used for all default checks in the library (#2101)

## v1.0.1¶

### Bug Fixes¶

• Fix issue with speaking state being cast to int when it was invalid.

• Fix some issues with loop cleanup that some users experienced on Linux machines.

• Fix voice handshake race condition (#2056, #2063)

## v1.0.0¶

The changeset for this version are too big to be listed here, for more information please see the migrating page.

## v0.16.6¶

### Bug Fixes¶

• Fix issue with Client.create_server() that made it stop working.

• Fix main thread being blocked upon calling StreamPlayer.stop.

• Handle HEARTBEAT_ACK and resume gracefully when it occurs.

• Fix race condition when pre-emptively rate limiting that caused releasing an already released lock.

• Fix invalid state errors when immediately cancelling a coroutine.

## v0.16.1¶

This release is just a bug fix release with some better rate limit implementation.

### Bug Fixes¶

• Servers are now properly chunked for user bots.

• The CDN URL is now used instead of the API URL for assets.

• Rate limit implementation now tries to use header information if possible.

• Event loop is now properly propagated (#420)

• Allow falsey values in Client.send_message() and Client.send_file().

## v0.16.0¶

### New Features¶

• Add Channel.overwrites to get all the permission overwrites of a channel.

• Add Server.features to get information about partnered servers.

## v0.15.1¶

• Fix crash on duplicate or out of order reactions.

## v0.15.0¶

### New Features¶

For the command extension, the following changed:

• Context is no longer slotted to facilitate setting dynamic attributes.

## v0.14.3¶

### Bug Fixes¶

• Fix crash when dealing with MESSAGE_REACTION_REMOVE

• Fix incorrect buckets for reactions.

## v0.14.2¶

### New Features¶

• Client.wait_for_reaction() now returns a namedtuple with reaction and user attributes.
• This is for better support in the case that None is returned since tuple unpacking can lead to issues.

### Bug Fixes¶

• Fix bug that disallowed None to be passed for emoji parameter in Client.wait_for_reaction().

## v0.14.1¶

### Bug fixes¶

• Fix bug with Reaction not being visible at import.
• This was also breaking the documentation.

## v0.14.0¶

This update adds new API features and a couple of bug fixes.

## v0.13.0¶

This is a backwards compatible update with new features.

### Bug Fixes¶

• Paginator pages do not exceed their max_size anymore (#340)

• Do Not Disturb users no longer show up offline due to the new changes.

## v0.12.0¶

This is a bug fix update that also comes with new features.

### New Features¶

• Adds a new class to represent a custom Emoji named

• Adds a utility generator function, Client.get_all_emojis().

• Adds a list of emojis on a server, Server.emojis.

• Adds a new event, on_server_emojis_update().

• Add new server regions to ServerRegion

• ServerRegion.eu_central and ServerRegion.eu_west.

• Add support for new pinned system message under .

• Add order comparisons for to allow it to be compared with regards to hierarchy.

• This means that you can now do role_a > role_b etc to check if role_b is lower in the hierarchy.

• Add Server.role_hierarchy to get the server’s role hierarchy.

• Add Member.server_permissions to get a member’s server permissions without their channel specific overwrites.

• Add Client.get_user_info() to retrieve a user’s info from their ID.

• Add a new Player property, Player.error to fetch the error that stopped the player.

• To help with this change, a player’s after function can now take a single parameter denoting the current player.

• Add support for server verification levels.

• Adds a new enum called .

• This enum can be used in Client.edit_server() under the verification_level keyword argument.

• Adds a new attribute in the server, Server.verification_level.

• Add Server.voice_client shortcut property for Client.voice_client_in().

• This is technically old (was added in v0.10.0) but was undocumented until v0.12.0.

For the command extension, the following are new:

• All default converters that can take IDs can now convert via ID.

• Add coroutine support for Bot.command_prefix.

• Add a method to reset command cooldown.

### Bug Fixes¶

• Fix bug that caused the library to not work with the latest websockets library.

• Fix bug that leaked keep alive threads (#309)

• Fix bug that disallowed ServerRegion from being used in Client.edit_server().

• Fix bug in Channel.permissions_for() that caused permission resolution to happen out of order.

• Fix bug in that did not account for same-position roles.

## v0.11.0¶

This is a minor bug fix update that comes with a gateway update (v5 -> v6).

### New Features¶

• Add the ability to prune members via Client.prune_members().

• Switch the websocket gateway version to v6 from v5. This allows the library to work with group DMs and 1-on-1 calls.

• Add CallMessage for group voice call messages.

• Add GroupCall for group voice call information.

• Add to get the system message.

• Add the remaining VIP servers and the Brazil servers into ServerRegion enum.

• Add stderr argument to VoiceClient.create_ffmpeg_player() to redirect stderr.

• The library now handles implicit permission resolution in Channel.permissions_for().

• Add Server.mfa_level to query a server’s 2FA requirement.

• Add attribute that refers to a .

• For backwards compatibility, the member object will have properties mirroring the old behaviour.

For the command extension, the following are new:

• Command cooldown system with the cooldown decorator.

• UserInputError exception for the hierarchy for user input related errors.

### Bug Fixes¶

• Client.email is now saved when using a token for user accounts.

• Fix issue when removing roles out of order.

• Fix bug where discriminators would not update.

• Handle cases where HEARTBEAT opcode is received. This caused bots to disconnect seemingly randomly.

For the command extension, the following bug fixes apply:

• Bot.check decorator is actually a decorator not requiring parentheses.

• Bot.remove_command and Group.remove_command no longer throw if the command doesn’t exist.

• Command names are no longer forced to be lower().

• Fix a bug where Member and User converters failed to work in private message contexts.

• HelpFormatter now ignores hidden commands when deciding the maximum width.

## v0.10.0¶

For breaking changes, see Migrating to v0.10.0. The breaking changes listed there will not be enumerated below. Since this version is rather a big departure from v0.9.2, this change log will be non-exhaustive.

### New Features¶

• The library is now fully asyncio compatible, allowing you to write non-blocking code a lot more easily.

• The library now fully handles 429s and unconditionally retries on 502s.

• A new command extension module was added but is currently undocumented. Figuring it out is left as an exercise to the reader.

• Two new exception types, and to denote permission errors or 404 errors.

• Added support for sending voice. Check for more details.

• Added Client.wait_for_message() coroutine to aid with follow up commands.

• Added named tuple to check version info of the library.

• Login credentials are now cached to have a faster login experience. You can disable this by passing in cache_auth=False when constructing a .

• New utility function, to simplify retrieval of items based on attributes.

• All data classes now support !=, ==, hash(obj) and str(obj).

• Added Client.get_bans() to get banned members from a server.

• Added Client.invites_from() to get currently active invites in a server.

• Added Server.me attribute to get the version of .

• Most data classes now support a hash(obj) function to allow you to use them in set or dict classes or subclasses.

• Add to get a text version of the content with the user and channel mentioned changed into their names.

• Added a way to remove the messages of the user that just got banned in Client.ban().

• Added Client.wait_until_login() to facilitate easy creation of tasks that require the client to be logged in.

• Add to represent any game with custom text to send to Client.change_status().

• Add Member.permissions_in() as another way of doing Channel.permissions_for().

• Add Client.move_member() to move a member to another voice channel.

• You can now create a server via Client.create_server().

• Added Client.edit_server() to edit existing servers.

• Added Client.server_voice_state() to server mute or server deafen a member.

• If you are being rate limited, the library will now handle it for you.

• Add and events that trigger when a member is banned/unbanned.

### Performance Improvements¶

• All data classes now use __slots__ which greatly reduce the memory usage of things kept in cache.

• Due to the usage of asyncio, the CPU usage of the library has gone down significantly.

• A lot of the internal cache lists were changed into dictionaries to change the O(n) lookup into O(1).

• Compressed READY is now on by default. This means if you’re on a lot of servers (or maybe even a few) you would receive performance improvements by having to download and process less data.

• While minor, change regex from \d+ to [0-9]+ to avoid unnecessary unicode character lookups.

### Bug Fixes¶

• Fix bug where guilds being updated did not edit the items in cache.

• Fix bug where member.roles were empty upon joining instead of having the @everyone role.

• Fix bug where Role.is_everyone() was not being set properly when the role was being edited.

• Client.logs_from() now handles cases where limit > 100 to sidestep the disnake API limitation.

• Fix bug where a role being deleted would trigger a ValueError.

• Fix bug where and were flipped.

• Mentions are now triggered normally. This was changed due to the way disnake handles it internally.

• Fix issue when a would attempt to upgrade a Message.server when the channel is a .

• Unavailable servers were not being added into cache, this has been corrected.