nextcord

library3.2.0pypypi✓ verified 84d ago

Nextcord is a modern, asynchronous Python wrapper for the Discord API, forked from discord.py after v1.7.3. It aims to keep compatibility while adding new Discord features. Current version is 3.2.0, supporting Python 3.12+. Release cadence is irregular, with major updates roughly yearly.

communication

pip install nextcord

github ↗homepage ↗

INSTALL

IMPORT

SIG · NEXTCORD

nextcord

communicationpythonv3.2.0

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

Client

✓ from nextcord import Client

Nextcord is a fork; using discord.py imports will fail at runtime.

Intents

✓ from nextcord import Intents

Intents must be explicitly enabled. Mistake: omitting intents, resulting in empty cache.

Embed

✓ from nextcord import Embed

Embed construction is same as discord.py but import path differs.

Basic bot with command prefix and ready event. Replace 'TOKEN' with your bot token.

import nextcord from nextcord.ext import commands bot = commands.Bot(command_prefix='!', intents=nextcord.Intents.default()) @bot.event async def on_ready(): print(f'Logged in as {bot.user}') @bot.command() async def ping(ctx): await ctx.send('Pong!') bot.run('TOKEN')

Debug

Known issues

breakingNextcord 2.0+ dropped support for Python <3.8. Nextcord 3.0+ requires Python >=3.12. Upgrade your Python version if using older releases.

fix

Install Python 3.12 or newer, then upgrade nextcord.

affects: >=3.0.0

breakingAttachments now have a different API: attachment.url is no longer available; use attachment.proxy_url or attachment.url returns the CDN URL but requires intent changes.

fix

Replace attachment.url with attachment.proxy_url or attachment.url after enabling the new intent.

affects: >=2.0.0

gotchaMembers and presence intents are now privileged. If your bot does not see members, you likely forgot to enable them in the Discord Developer Portal and in code.

fix

1. Enable 'Server Members Intent' and 'Presence Intent' in Discord Developer Portal. 2. Pass intents=nextcord.Intents.all() or intents=nextcord.Intents(members=True, presences=True) to your bot/client.

affects: all

deprecatedThe `nextcord.ext.commands.Bot` constructor parameter `case_insensitive` is deprecated; use `case_insensitive=True` inside `command_prefix` as a callable instead.

fix

Replace `case_insensitive=True` with `command_prefix=lambda bot, msg: '!' if ... else '?'` or use discord.py style `when_mentioned`.

affects: <3.0.0

Errors

Common errors & fixes

AttributeError: module 'nextcord' has no attribute 'Intents'

Maybe you have a file named nextcord.py shadowing the module, or installed an old version (pre-1.0).

fix

Rename your file (e.g., my_bot.py). Upgrade nextcord: pip install -U nextcord.

AttributeError: 'Client' object has no attribute 'command'

Using `from nextcord import Client` and trying to use the command decorator. The decorator requires `commands.Bot`.

fix

Use `from nextcord.ext import commands` and instantiate `bot = commands.Bot(command_prefix='!', intents=...)`.

discord.errors.PrivilegedIntentsRequired

Your bot uses intents requiring special enablement (members, presences, message content).

fix

Enable them in the Discord Developer Portal under 'Bot' settings. Then update code: `intents = nextcord.Intents.all()` or explicit intents.

Upgrade

Version history

3.2.0latest on PyPI · released May 21, 2026

Audit

Dependencies

aiohttprequiredRequired for HTTP requests to Discord API.

yarlrequiredUsed by aiohttp for URL handling.

Agent activity

20 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/nextcord/nextcord ↗

homepagehttps://github.com/nextcord/nextcord ↗