Discord API · error code

Discord error 30008: Maximum number of emojis reached

Permanent - do not retryHTTP 400Maximum reached (30xxx)

Last verified against Discord Developer Docs - Opcodes and status codes

What Discord returns
Maximum number of emojis reached

What error 30008 means

The guild has used every static custom emoji slot it has, so Create Guild Emoji (POST /guilds/{guild.id}/emojis) was refused. The number of slots is not fixed: it grows with the server's boost level, which is why the literal message gives no number. A server that loses boosts keeps its existing emojis but cannot add more until it is back under its allowance.

Static and animated emojis are counted separately. A server can be full on static emojis while still having animated slots free, and the reverse case returns 30018. Emojis tied to role subscriptions have their own cap, 25 per guild.

Emoji-stealing or emoji-import commands are the usual trigger, especially bulk imports that loop over a list without checking how many slots remain.

What it looks like

{
  "message": "Maximum number of emojis reached",
  "code": 30008
}

Why it happens

  • Static emoji slots for the server's boost level are full
  • Server lost boosts and dropped to a lower slot allowance
  • Bulk import command uploads more emojis than the free slots
  • Bot creates an emoji per user or per item without cleanup

How to fix Discord error 30008

  1. 1Fetch GET /guilds/{guild.id}/emojis and count non-animated entries
  2. 2Read the guild's premium_tier to know what allowance applies
  3. 3Ask an admin to delete unused emojis, then retry the upload
  4. 4Stop a bulk import at the first 30008 and report how many were added
  5. 5For emojis your bot uses in its own messages, upload them as application emojis instead of guild emojis

How to stop it recurring

Before an import, count free slots and tell the admin up front how many emojis will fit. If the emojis are for the bot's own UI, application-owned emojis (up to 2,000 per app) avoid guild slots entirely. Emoji and file caps are on the Discord limits page.

Official reference: Discord Developer Docs - Opcodes and status codes. See all Discord error codes or the Discord limits and quotas.

Related codes

Error 30008 - quick answers

What does Discord error 30008 mean?

The guild has used every static custom emoji slot it has, so Create Guild Emoji ( POST /guilds/{guild.id}/emojis ) was refused. The number of slots is not fixed: it grows with the server's boost level, which is why the literal message gives no number. A server that loses boosts keeps its existing emojis but cannot add more until it is back under its allowance. Static and animated emojis are counted separately.

How do I fix Discord error 30008?

1. Fetch GET /guilds/{guild.id}/emojis and count non-animated entries 2. Read the guild's premium_tier to know what allowance applies 3. Ask an admin to delete unused emojis, then retry the upload 4. Stop a bulk import at the first 30008 and report how many were added 5. For emojis your bot uses in its own messages, upload them as application emojis instead of guild emojis

Should I retry after error 30008?

No. Retrying the same request produces the same error; the condition has to be fixed first. Treat it as a permanent failure for that message and surface it, rather than looping.

Stop debugging Discord by hand

Connect the channel through Conferbot: tokens, webhooks and retries are handled, failures show as readable status.