Discord error 30033: Maximum number of thread participants has been reached (1000)
Last verified against Discord Developer Docs - Opcodes and status codes
Maximum number of thread participants has been reached (1000)What error 30033 means
A thread can have at most 1,000 members, and your request would add one more. The usual call is PUT /channels/{channel.id}/thread-members/{user.id}, which a bot uses to pull a user into a thread, or PUT /channels/{channel.id}/thread-members/@me when the bot joins itself.
Thread membership in Discord is what makes a thread show in someone's sidebar and receive notifications. Bots that add every member of a role to a thread for visibility hit this cap quickly in large servers, as do event and announcement threads that auto-add attendees.
Users can still read a public thread without being members of it. Being full only stops new members from being added, not from viewing.
Each add or removal is also delivered to clients as thread member updates, so bulk-adding members creates a burst of gateway traffic as well as REST calls.
What it looks like
{
"message": "Maximum number of thread participants has been reached (1000)",
"code": 30033
}Why it happens
- Bot adds every member of a large role to one thread
- Event or giveaway thread auto-adds each participant
- Long-lived support thread accumulated members over time
How to fix Discord error 30033
- 1Check the thread's member_count before adding more members
- 2Mention the role in the thread instead of adding each member individually
- 3Create a new thread for overflow, or remove inactive members with DELETE /channels/{channel.id}/thread-members/{user.id}
- 4Retry the add only after the count drops below 1,000
- 5Add members in small batches that respect the rate-limit headers, rather than in a tight loop
How to stop it recurring
Use threads for focused conversations and channels for large audiences. If a feature needs to notify hundreds of people, a role mention or a channel post scales better than adding each person to a thread. Related caps on active threads are covered on 160006.
Official reference: Discord Developer Docs - Opcodes and status codes. See all Discord error codes or the Discord limits and quotas.
Related codes
- 160006: Maximum number of active threads reachedMaximum number of active threads reached
- 50083: Operation on an archived threadTried to perform an operation on an archived thread, such as editing a message…
- 160005: Thread is lockedThread is locked
- 50013: Missing permissionsYou lack permissions to perform that action
Error 30033 - quick answers
What does Discord error 30033 mean?
A thread can have at most 1,000 members, and your request would add one more. The usual call is PUT /channels/{channel.id}/thread-members/{user.id} , which a bot uses to pull a user into a thread, or PUT /channels/{channel.id}/thread-members/@me when the bot joins itself. Thread membership in Discord is what makes a thread show in someone's sidebar and receive notifications.
How do I fix Discord error 30033?
1. Check the thread's member_count before adding more members 2. Mention the role in the thread instead of adding each member individually 3. Create a new thread for overflow, or remove inactive members with DELETE /channels/{channel.id}/thread-members/{user.id} 4. Retry the add only after the count drops below 1,000 5. Add members in small batches that respect the rate-limit headers, rather than in a tight loop
Should I retry after error 30033?
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.