How to Link Twitch to Discord: Sub Roles Guide 2026
Linking Twitch to Discord takes about 90 seconds: open User Settings → Connections, click Twitch, authorize, and toggle "Display on profile." For automatic sub role assignment, partnered/affiliate streamers connect their Twitch in Server Settings → Integrations and Discord auto-syncs subscribers to a chosen role. PeakBot fills the gaps when the native integration breaks or you need extra logic.
Key Takeaways
- Personal Twitch-Discord linking shows your account on profiles but does not grant sub roles.
- Sub role syncing only works for Twitch Affiliates and Partners with a connected server.
- Discord syncs subs roughly every 5-10 minutes — not instant, but usually fast enough.
- The integration occasionally desyncs after Twitch auth refreshes; PeakBot's role manager catches these cases.
- Tier 1, 2, and 3 subs can each map to different Discord roles.
Why Link Twitch to Discord at All?
Linking Twitch and Discord serves two distinct purposes that get conflated constantly:
- Personal display — show your Twitch handle on your Discord profile so friends can find your stream.
- Server sub syncing — automatically grant Discord roles to your Twitch subscribers.
These are completely separate features with different setup paths. Most "how to link Twitch to Discord" guides only cover the first one and leave streamers stuck wondering why their subs aren't getting roles. We're going to cover both, and then explain what to do when the native integration falls short.
I've configured Twitch-Discord syncing for roughly 40 streamer servers ranging from 200-member communities to 80,000-member ones. The patterns are consistent: native works for the simple case, breaks for anything custom.
How Do You Link Your Personal Twitch Account to Discord?
This is the user-level integration that shows your Twitch on your Discord profile.
Step 1: Open User Settings
Click the gear icon next to your username at the bottom-left of Discord (desktop) or tap your avatar in the bottom-right (mobile).
Step 2: Navigate to Connections
In the left sidebar of User Settings, find Connections. You'll see a grid of supported services: Twitch, YouTube, Steam, Spotify, PlayStation, Xbox, etc.
Step 3: Click the Twitch Icon
A browser window opens asking you to authorize Discord to read your Twitch account info. Click Authorize.
Step 4: Configure Display Options
Back in Discord, your Twitch connection now appears with two toggles:
- Display on profile — shows the Twitch icon and link on your profile card
- Sync — pulls your sub roles from any servers you're subscribed to (more on this below)
Toggle both on for the full experience.
How Do Twitch Sub Roles Work in Discord?
Sub role syncing is a separate, server-side integration that requires the streamer (not the viewer) to set it up. Here's the flow:
| Role | What They Do |
|---|---|
| Streamer (Affiliate/Partner) | Connects Twitch to their Discord server in Server Settings → Integrations |
| Viewer (Subscriber) | Links their personal Twitch to Discord and toggles "Sync" |
| Discord | Polls Twitch every 5-10 minutes, auto-assigns role to subscribers |
If any link in this chain breaks — viewer didn't toggle Sync, streamer's auth expired, Twitch API rate-limited — the sub doesn't get the role.
What You Need to Sync Subs
- Twitch Affiliate or Partner status (Affiliate is free; minimum 50 followers, 500 stream minutes, 7 unique days, average 3 viewers).
- A Discord server where you have Manage Server permission.
- A role to assign to subscribers (create one before integrating).
Non-affiliate streamers cannot sync subs natively. You'd need a bot solution like PeakBot or a custom integration.
How Do You Set Up Sub Role Syncing as a Streamer?
This is the streamer-side flow that actually creates the sub role pipeline.
Step 1: Create the Sub Roles First
Server Settings → Roles → Create Role. Name them clearly:
- @Tier 1 Sub
- @Tier 2 Sub
- @Tier 3 Sub
Color them however you want. Don't grant them admin permissions — Discord lets viewers self-assign by subscribing, so giving them admin is a security hole.
Step 2: Open Server Settings → Integrations
Scroll down in Server Settings until you see Integrations. Click it. You'll see a list including Twitch, YouTube, and any bots you have installed.
Step 3: Click Twitch and Authorize
Discord opens a browser window. Authorize with your Twitch (must be the same account you stream from). The Twitch channel now appears in Integrations.
Step 4: Map Twitch Tiers to Discord Roles
Click your Twitch integration to open settings. You'll see three rows:
- Tier 1 → dropdown to pick role
- Tier 2 → dropdown to pick role
- Tier 3 → dropdown to pick role
Pick the matching role for each tier. Save.
Step 5: Tell Your Subs to Toggle Sync
This is the step nobody mentions. Subs need to:
- Have their Twitch linked to Discord (User Settings → Connections)
- Have Sync toggled ON
Pin a message in your server with these instructions. I've seen 30%+ of subs never get their role simply because they didn't know about the Sync toggle.
How Do You Verify the Sync Is Working?
The first sync after setup takes about 10 minutes. After that, Discord polls Twitch roughly every 5 minutes for changes.
Test the Sync
- Subscribe to your own channel using a test account (Twitch allows this).
- Wait 10 minutes.
- Check the test account in your Discord member list — they should have the @Tier 1 Sub role.
If the role doesn't apply:
- Confirm the test account has its Twitch linked AND Sync toggled.
- Confirm the integration in Server Settings shows "Active."
- Re-authorize the Twitch integration on your end.
Common Sync Failures
| Symptom | Cause | Fix |
|---|---|---|
| Sub role never applies | Viewer didn't toggle Sync | Pin instructions, send DM |
| Role disappears after a week | Twitch auth expired | Re-authorize integration |
| Tier 2/3 not detected | Discord cached Tier 1 | Wait 24 hours, re-sub |
| Whole server desynced | Discord-Twitch API outage | Check Discord status |
What Are the Alternatives When Native Sync Fails?
The native integration is good but brittle. If you're hitting frequent sync failures, here are the real-world alternatives.
Option 1: PeakBot Twitch Module
PeakBot includes a Twitch integration that runs alongside the native one. It catches subs that Discord misses, sends notifications when a sub goes live, and handles tier upgrades. Setup takes about 5 minutes via the dashboard.
Option 2: StreamElements / Streamlabs
These are streamer-focused tools with deeper Twitch hooks. They're great if you also need overlays and chat bots, but they're heavyweight for Discord-only sub syncing.
Option 3: Webhook-Based Custom Integration
If you have engineering resources, you can hit the Twitch EventSub API and Discord's bot API to build a custom sync. This gives you total control but requires hosting and maintenance. Most streamers don't need this.
For 90% of streamers, the answer is "native + PeakBot as a backup." Native covers the happy path; PeakBot catches the edge cases.
How Do You Notify Discord When You Go Live?
Sub roles are one piece. The other big use case is "@everyone, I'm live!" notifications.
Native Discord Doesn't Do This
Surprising fact: Discord's built-in Twitch integration syncs subs but does NOT post live notifications. You need a bot or webhook for that.
Setting Up Live Alerts With PeakBot
- Open the PeakBot dashboard
- Go to Streamer Alerts → Add Streamer
- Enter your Twitch username
- Pick the channel where alerts post
- Customize the alert message (Markdown supported)
PeakBot polls Twitch every 60 seconds and posts the alert within 1-2 minutes of going live. Free tier supports up to 3 streamers per server; Pro at $8.50/month is unlimited.
What Permissions Do Your Bots Need?
If you're using PeakBot or any other bot for Twitch integration:
| Permission | Why It's Needed |
|---|---|
| Manage Roles | Assign sub roles when native sync fails |
| Send Messages | Post live alerts |
| Embed Links | Make alerts look clean |
| Mention Everyone | Optional, for @here/@everyone alerts |
| Read Message History | Detect duplicate alerts |
Grant these to a dedicated bot role positioned ABOVE the sub roles you want it to manage. Discord enforces role hierarchy strictly.
Frequently Asked Questions
Why isn't my Twitch sub showing up as a Discord sub?
The most common cause: the subscriber hasn't toggled Sync on their Discord-Twitch connection. Walk them through User Settings → Connections → Twitch → toggle Sync. Second most common: the streamer's integration auth expired. Re-authorize from Server Settings → Integrations. If both are correct, wait 10 minutes for the next poll cycle to complete.
Can I link Twitch to Discord without being an Affiliate?
You can link your personal Twitch account regardless of Affiliate status — that just shows your Twitch on your Discord profile. However, sub role syncing requires Affiliate or Partner status because non-Affiliates don't have subscribers in the Twitch sense. If you want pseudo-sub roles for Patreon supporters, PeakBot supports Patreon integration as an alternative.
Does Discord still support Twitch Prime sub syncing?
Yes, Twitch Prime subs (now called Prime Gaming subs) sync identically to Tier 1 subs in Discord's integration. The viewer redeems their free Prime sub on Twitch, and Discord picks it up on the next poll cycle. Note that Prime subs expire after 30 days unless re-redeemed, so the role auto-removes when the sub lapses.
How long does it take for sub roles to apply after subscribing?
Typically 5-15 minutes. Discord polls Twitch on a regular cadence rather than receiving real-time webhooks, so there's always some lag. If the role hasn't applied after 30 minutes, the sub probably hasn't toggled Sync on their Discord-Twitch connection. Send them a DM with setup instructions or pin a public message in your server.
Can I have different roles for Tier 1, 2, and 3 subs?
Yes, this is the default supported configuration. In Server Settings → Integrations → your Twitch channel, you'll see three tier mappings. Assign a different Discord role to each tier. Tier 3 subs automatically get Tier 3 only, not all three tiers — if you want stacking, create the hierarchy manually with PeakBot's role rules.
Conclusion
Linking Twitch to Discord is two separate workflows that get conflated: personal account display and server sub role syncing. Both take under 5 minutes once you know which path you need.
The native integration handles the happy path well, but it's brittle around auth refreshes, tier changes, and live notifications (which it doesn't do at all). PeakBot fills those gaps for free, with 30+ features including streamer alerts, backup sub syncing, and Patreon integration. The free tier handles most streamer needs; Pro at $8.50/month is unlimited streamers and advanced automation. See how it stacks up in our PeakBot vs MEE6 comparison, check the setup docs, or browse the blog for more streamer guides. For Twitch API specifics, Twitch's official Help Center is the authoritative reference.
