“RuntimeWarning: coroutine ‘BotBase.load_extension’ was never awaited” after updating discord.py


As of discord.py version 2.0, Bot.load_extension is now a coroutine and has to be awaited. This is to allow Cog subclasses to override cog_unload with a coroutine.


await must be used in front of client.load_extension, as shown:

await client.load_extension("your_extension")

In each of your cogs:

Replace the standard setup function with an asynchronous one:

async def setup(bot):
    await bot.add_cog(YourCog(bot))

If you want to use the normal convention for adding extensions, you’ll need to use the following code:

In your client’s file:

async def load_extensions():
    for filename in os.listdir("./cogs"):
        if filename.endswith(".py"):
            # cut off the .py from the file name
            await client.load_extension(f"cogs.{filename[:-3]}")

You should also wrap your login in an asynchronous ‘main’ function, where you would call this function. Note that the code below does not setup logging, you need to do so yourself:

async def main():
    async with client:
        await load_extensions()
        await client.start('your_token')


These two functions replace the old way:


along with the code you posted in your question.


discord.py 2.0 async changes (Thank you ChrisDewa for mentioning this in your comment)

Leave a Comment