Patreon mechanics · 2026-06-06

Patreon Discord bot: how it works, setup steps, and role automation 2026

Patreon's official Discord integration automatically assigns roles to patrons when they subscribe and revokes those roles when they cancel or fail payment. Here's how it works, how to set it up, and why the most common failures aren't bot errors — they're Discord permission hierarchy problems.

How the integration works

Patreon connects to Discord via OAuth2 — the same mechanism used by most third-party Discord integrations. When a patron subscribes to your Patreon page, three things happen automatically:

1. Patreon checks whether the patron has linked their Discord account to their Patreon account (Settings → Connected Apps on the patron side)
2. If linked, Patreon's bot assigns the Discord role you've mapped to that tier
3. When the patron cancels, fails a payment, or declines renewal, the role is revoked

The bot runs continuously — role changes typically propagate within minutes of a subscription event, not on a daily sync. Cancellations are processed at the end of the patron's billing period (they keep the role until the period they paid for expires).

One role per tier is the maximum — Patreon maps each tier to exactly one Discord role. You can stack roles if you structure your tiers so higher tiers inherit from lower ones, but that requires duplicate tier setup. Patreon does not natively add multiple roles for one subscription.

Setup step by step

Both sides need configuration: the Discord server side and the Patreon page side.

Discord server side (do this first)

1. Create the Discord roles you want to assign — one per Patreon tier. Name them clearly (e.g., "Supporter", "Community Member", "Founding Member"). Do not use existing admin roles for patron assignment.
2. Invite Patreon's bot to your server. The invite link is available from your Patreon creator dashboard under Settings → Apps → Discord. When the bot joins, it arrives with a role called something like "Patreon" in your role list.
3. In your Discord server settings under Roles, drag the bot's "Patreon" role above all the patron roles you created. This is the most common setup error — the bot can only assign roles ranked below its own role in the hierarchy. If your patron role is above the bot's role, assignment silently fails.

Patreon page side

1. In your Patreon creator dashboard, go to Settings → Apps → Discord
2. Authorize Patreon to connect to your Discord server
3. For each tier, use the dropdown to select which Discord role it maps to
4. Save. The integration is live immediately for future subscriptions

Existing patrons who subscribed before the integration was set up will not automatically receive their roles. They need to link their Discord account on their Patreon account settings page (Settings → Connected Apps) — the bot then assigns their role within minutes.

What the bot can and cannot do

Common failures and fixes

Role not assigned after subscribe

The most common cause: the patron has not linked their Discord account to their Patreon account. Patreon can only assign Discord roles to patrons whose accounts are linked. Ask the patron to go to their Patreon account settings → Connected Apps and link their Discord. The role should appear within a few minutes.

Second most common cause: the bot's role is below the patron role in the Discord hierarchy. Fix this by going to your Discord server settings → Roles and dragging the Patreon bot role above all patron-facing roles.

Role not removed after cancel

Patreon removes roles at the end of the patron's paid period — not immediately on cancellation. A patron who cancels on day 5 of a monthly cycle keeps their role until day 30 (or whenever their billing period ends). This is correct behavior, not a bug. If a role persists past the billing end date, the patron may need to re-link their Discord account.

Bot leaves the server

If an admin removes the Patreon bot from the server or revokes its permissions, the integration breaks silently — Patreon will no longer be able to assign or revoke roles. Re-invite the bot from the Patreon creator dashboard and re-authorize.

The Apple Tax angle (November 2026)

Starting November 1, 2026, Patreon subscriptions purchased through the iOS app trigger Apple's 30% IAP fee. This does not affect how the Discord integration works — role assignment functions the same regardless of how the patron subscribed. However, if iOS patrons decline to re-subscribe after the price effectively increases (because their renewal now includes Apple's fee), you may see role revocations spike after November 1 as failed renewals propagate.

Patreon's web-only toggle (which prevents iOS in-app billing) does not affect Discord role assignment. If you enable web-only mode, patrons must subscribe via browser, but role assignment on subscribe and revocation on cancel work identically.

Does KeepTier support Discord role automation?

Yes. KeepTier includes Discord role automation at all plan levels — assign roles on subscribe, revoke on cancel, multiple tiers mapped to multiple roles. At $9/mo flat fee with no platform commission, it's an alternative for creators who find Patreon's 8% commission material at their revenue level.