Discord is a great tool for engaging with your community. Our team has created this troubleshooting guide to help you through some of the more common things we find that can cause problems with the integration.
Most often, one of the steps below resolves issues with the Discord integration:
- Is the Patreon Bot in the right position?
- Have you removed or added any permissions to the bot?
- Is there a second Bot on your Discord server?
- Has the patron connected Discord to their Patreon account?
- Is the patron in the right tier?
Fun fact: The Patreon bot is offline– it’s broken!
Incorrect. The Patreon bot is offline when it’s not actively assigning roles. If you find that the bot is offline, it’s still working and is waiting to assign a role.
IMPORTANT: Do not remove the Patreon Bot from Discord. There will be no way to add the bot back after it has been removed. Additionally, if the bot is removed, you will not be able to disconnect Discord from Patreon as the bot is what manages this connection.
Also important to note: The Patreon bot is delayed at the 1st of the month, so new patrons may not be added to Discord instantly. However, they will be added shortly and there’s no action needed. If you are experiencing patrons with declined payments who have lost access, once their payment processes they will regain access.
Is the Patreon bot above your tier roles?
It sounds simple, but it’s always a good step to double check that roles you assigned to tiers are below the Patreon bot on your Discord server.
Log in to your Patreon account and check the Advanced section of your editor. If you receive this error message, you’ll want to log in to Discord and drag the Patreon bot to the top of your roles:
To resolve this
If you receive the error message above when you visit the advanced section of your editor, log in to your Discord account and drag the Patreon bot above your other roles:
Have you removed or added any permissions for the Patreon bot?
When you authorize the connection between Patreon and Discord and add your server, there are two permissions enabled for the Patreon bot that should not be changed. The Patreon bot must have the following permissions enabled:
- Manage Roles
- Create Invites for the server
If your bot is at the top of your roles list, but patrons still aren’t being assigned their role, double check that these two permissions are enabled. If not, toggle them back on and save your changes. Your permissions should look like the image below:
What if I’ve added permissions to my bot?
The Patreon bot only needs the permission to manage roles and create invites on your server. If you’ve added other permissions to the Patreon bot role, toggle those permissions off and save your changes. The added permissions are not needed, and may tamper with the integration.
Do you have a second bot on your Discord server?
While we’ve had many creators use more than our bot on their discord server, we’ve also encountered instances where the second bot can interfere with the Patreon bot’s job–assigning roles.
If you have a second bot on your Discord server (other than the Patreon bot), check the following on your server settings in Discord:
- The Patreon bot has permission to create invites to the server and manage roles.
- The second bot you have on your Discord server is not adding, or removing any roles from the Patreon bot.
- The second bot is not assigning any roles to the Patreon bot – this can lead to #2 above.
Your Patreon bot’s permissions should look like the image below. If there are other permissions added (or if either of the required two have been turned off) please correct the settings and try reconnecting from your to get patrons their roles.
If you have a second bot that is assigning roles to the Patreon bot, remove the bot, or ensure that that bot does not have the permission to assign roles to the Patreon bot.
Has the patron connected Discord to their Patreon account?
If a patron messages you saying that they don’t have access to your Discord server, double check that they've connected Discord to their Patreon account. Search the patron’s name in your – if there’s a Discord username for this patron, it means that they’ve connected to Discord successfully.
Not finding a Discord username? Ask the patrons to log in and check that they’ve connected to Discord in the of their settings.
Feel free to share we’ve made for patrons to troubleshoot Discord access.
Check the patron's tier level
If a patron has messaged you and you find that they have Discord connected, it’s possible that a patron increased their membership payment amount without selecting a tier of yours that has a Discord role tied to it.
Search for the patron in your – you can identify which tier they selected in the information card in the upper right. If the patron has a status of “No reward” or is in a tier that doesn’t have a Discord role associated with it, you’ll want to send them a message and ask them to join the tier that unlocks the Discord role.
Once they select the correct tier, they’ll automatically be added to the server with the appropriate role, and can log in to Discord to access.