Here are the most common issues you might experience with Podia's Discord integration and how to troubleshoot them.
General issues
Discord won't connect
If you're having issues connecting your Discord server to Podia, make sure you:
Have properly authorized the Podia bot when connecting your Discord account
Have the necessary permissions to manage the Discord server and add new apps
Customers are not being properly added to Discord
If customers are not being properly added to Discord, you might need to check a couple of things related to role hierarchy and bot permissions.
Role hierarchy
Roles in Discord follow a hierarchy based on their position. Depending on where the role is located, a role can manage other roles lower in the hierarchy.
With that said, make sure the Podia bot role is placed above all of the roles it should be managing - especially the ones you're having issues with.
Bot permissions
Podia's Discord integration needs the following permissions for it to work correctly:
Manage Roles
Kick Members
Create Invite
If you’ve revoked any of these permissions, please grant them again by going to Server Settings → Roles → Podia bot in your Discord server.
Role assignment issues
Not all of my Discord roles appear on Podia
Roles in Discord follow a hierarchy based on their position. Depending on where the role is located, a role can manage other roles lower in the hierarchy.
With that said, the Podia role needs to be above all the roles you want it to manage.
If the Podia bot is below any roles you want it to manage, this is why the roles won’t appear on Podia or why customers aren’t being assigned the correct role in Discord.
Example: Podia bot is able to managed the Basic, Silver and Gold roles, but it won't be able to manage the VIP role.
This means the VIP role won't appear on Podia and you might have issues getting the correct role assigned to customers on Discord.
Roles are not being correctly assigned to customers
Roles in Discord follow a hierarchy based on their position. Depending on where the role is located, a role can manage other roles lower in the hierarchy.
With that said, make sure the Podia bot role is placed above all of the roles it should be managing - especially the ones you're having issues with.
Customer account issues
Discord user is already connected to another account
If one of your customers gets the error message “Discord user is already connected to another account” when they try to authorize the Podia Discord bot, it means that their Discord account is already linked to a different Podia account, even if they don’t remember doing so.
To fix this, locate the customer in your Podia Audience and delete their Podia account. Then, ask the customer to click the Discord link from their customer dashboard settings and try to login again.
Customer connected the wrong Discord account
Customers can quickly change the Discord username they connected to your Podia account directly from their customer dashboard.
After being logged in, customers will need to navigate to their Settings page.
From there, they can click on "Rejoin" next to Discord to connect their account, where they’ll also be able to change their username.
Customer didn't authorize the Podia bot
Once customers click to join the Discord server from Podia, they'll be asked to login or create an account (if they don't have a Discord account yet).
Once they login, they'll need to authorize the Podia Discord bot so we can fully manage their account and get them added to your Discord server.
If they fail to authorize the Podia bot, they’ll have issues joining your Discord server and letting us manage their profile.
They’ll need to click “Join Discord” from their customer dashboard settings for us to fully manage their profiles on Discord.
If you have any questions, send an email to [email protected] or click the purple help icon to send us a message 😄