Thread Manager
Create and manage Discord threads with full control over settings. Generate code for thread creation, archiving, member management, and more.
Thread Manager - Create and manage Discord threads with full control over settings. Threads are temporary sub-channels that help organize conversations.
Quick Examples
18/100 characters
How long before the thread automatically archives due to inactivity
0 = disabled, max 21600 (6 hours)
Thread Preview
General Discussion
PUBLIC// Create a public thread from a message
const message = await channel.send('Welcome to the thread! Feel free to discuss here.');
const thread = await message.startThread({
name: 'General Discussion',
autoArchiveDuration: 1440,
rateLimitPerUser: 0,
reason: 'Creating thread'
});
console.log(`Created thread: ${thread.name}`);
// Alternative: Create thread without a starter message (requires MANAGE_THREADS)
const thread = await channel.threads.create({
name: 'General Discussion',
autoArchiveDuration: 1440,
rateLimitPerUser: 0,
type: ChannelType.PublicThread,
reason: 'Creating thread'
});Understanding Discord Threads
What are Threads?
Threads are temporary sub-channels that branch off from existing text channels. They help organize conversations without cluttering the main channel. Threads automatically archive after a period of inactivity, keeping your server tidy.
Key Features:
- • Temporary: Automatically archive after inactivity
- • Organized: Keep conversations focused and separate
- • Searchable: Easy to find and reference past discussions
- • Flexible: Public, private, or announcement-based
Thread Types
Public Threads
Anyone who can view the parent channel can view and join public threads.
- • Visible to all members
- • Anyone can join
- • Best for open discussions
Private Threads
Only invited members and moderators can view and participate in private threads.
- • Invitation required
- • Hidden from others
- • Best for support tickets
Announcement Threads
Threads created in announcement channels for discussion about announcements.
- • In announcement channels
- • Can be followed
- • Best for update discussions
Thread Lifecycle
Active
Thread is created and members can send messages. Shows in the channel's active threads list.
Auto-Archive
After the specified inactivity period (1 hour, 24 hours, 3 days, or 1 week), the thread automatically archives.
Archived
Thread is read-only and hidden from active threads. Can be unarchived by sending a message (if not locked).
Locked (Optional)
When locked, only moderators with MANAGE_THREADS can unarchive. Useful for concluded discussions.
Required Permissions
| Operation | Required Permission | Notes |
|---|---|---|
| Create Public Thread | CREATE_PUBLIC_THREADS (1 << 35) | Or use message.startThread() |
| Create Private Thread | CREATE_PRIVATE_THREADS (1 << 36) | Also requires MANAGE_THREADS |
| Manage Threads | MANAGE_THREADS (1 << 34) | Archive, lock, delete any thread |
| Send in Threads | SEND_MESSAGES_IN_THREADS (1 << 38) | Required to participate |
| Add Thread Members | MANAGE_THREADS (1 << 34) | Add members to any thread |
Common Use Cases
💬 Discussion Threads
Create threads for specific topics without cluttering the main channel.
🎫 Support Tickets
Private threads for one-on-one support between members and staff.
📢 Announcement Discussion
Let members discuss announcements in dedicated threads.
🎮 Event Planning
Organize discussions about upcoming events or game nights.
Best Practices
Choose Appropriate Auto-Archive Duration
Use shorter durations (1-24 hours) for quick discussions, longer (3-7 days) for ongoing topics.
Use Descriptive Thread Names
Clear, descriptive names help members find relevant discussions and understand the topic at a glance.
Lock Threads When Resolved
Lock support tickets or concluded discussions to prevent them from being reopened unnecessarily.
Set Slowmode for Busy Threads
Use slowmode (5-30 seconds) in high-traffic threads to prevent spam and encourage thoughtful responses.
Use Private Threads for Sensitive Topics
Support tickets, moderation discussions, or personal matters should use private threads for privacy.
Monitor Thread Activity
Listen to threadCreate and threadUpdate events to track and moderate new threads automatically.
Archive Inactive Threads Manually
Don't wait for auto-archive - manually archive threads that are no longer relevant to keep things organized.
Limitations & Important Notes
- ⚠ Threads automatically archive after the specified inactivity period - this cannot be disabled
- ⚠ Private threads require both CREATE_PRIVATE_THREADS and MANAGE_THREADS permissions
- ⚠ Thread names can only be 1-100 characters long
- ⚠ Each channel has a limit on the number of active threads (default: 50 for most servers)
- ⚠ Archived threads remain searchable and accessible but cannot receive new messages until unarchived
- ⚠ Locked threads can only be unarchived by users with MANAGE_THREADS permission
- ⚠ Some thread features (like 1 week auto-archive) require server boost level 2