Integrate with Discord
Discord is a free platform where you can connect with other likeminded people via text, audio, or video. Memberful integrates directly with Discord making it easy to create a members-only community for any topic or industry. We invite paid members to your Discord server and remove their access once their subscription expires.
In this help doc:
- Connect to your Discord server.
- Public vs Private.
- Assign roles based on Plan.
- Common issues with role assignment.
- Post configuration tips.
- Email templates.
- Invite existing members.
- Find a member by their Discord ID.
Connect to your Discord server
Navigate to Settings → Integrate → Services from your Memberful dashboard, and activate the Discord integration.
Select your server from the dropdown and click Continue. If you don't see your server you may be signed into Discord as a user that does not have admin access. If that's the case, sign out of Discord and sign in as the admin, then follow the Activate link again.
After selecting your server, you have to grant permissions for the bot. We ask for the following:
- Manage Roles
- Kick Members
- Create Invite
Refusing to grant any of the above permissions will cause your integration to malfunction.
Once verified, click the Authorize button to connect. After a successful connection, you will be redirected to a configuration page within the Memberful admin.
Here you can configure the integration to:
- Be Public: Allow any member to join your Discord server.
- Be Private: Invite active members only, and remove those members if their subscription expires.
- Optionally assign what roles you wish to associate with Memberful Plans.
Public vs Private
Do you want to run an open community where everyone is welcome, but paying members have exclusive roles? Or do you prefer a private server where they are the only ones allowed in?
Our Public integration will invite all of your members to the server, even if they signed up for free. Paying members receive exclusive roles that are removed if their subscription lapses.
Our Private integration, on the other hand, only invites your paying members. They will receive the exclusive roles you configured, but if their subscription lapses, we'll remove them from the server.
Assign roles based on plan
You can associate Discord roles with Memberful Plans. When a member subscribes to the Plan, we'll give them the role you selected.
Common issues with role assignment
If your members are not getting the roles they were supposed to, or you do not see all of your roles on your Memberful configuration page, you might need to fix a couple of issues in your Discord server.
Roles in Discord follow a hierarchy based on position. Depending on its permissions, a role may be able to manage other roles that are lower in the hierarchy:
In the example above, the Memberful Bot can assign the Silver role to members, but it can't assign the Gold role. To fix this, drag the Memberful Bot role above all roles you want us to manage and click Save Changes:
To find the Role Management section in Discord, go to Server Settings → Roles.
For the integration to work correctly, we ask for the following permissions:
- Manage Roles
- Kick Members
- Create Invite
If you revoked any of these permissions, grant them again by going to Server Settings → Roles → Memberful Bot in your Discord server.
Post configuration tips
After enabling the Discord integration, if you decide to change a setting or add a new Plan you'll need to disable the Discord integration within Settings → Integrate → Services, make your changes, and re-enable the entire integration. In the background we queue the syncing process between your Discord server and your Memberful account.
Important note: While this is a completely safe action to take we recommend doing this as minimally as possible to avoid any interruptions.
Disabling the integration means any new subscriptions won't be invited to your server for a brief period. Existing members will not lose access to their Discord roles.
If you want new members to receive a Discord invite email when they buy a Plan, visit your email template settings and enable the Discord invite.
Invite existing members
Any existing member can visit the following URL to connect to the Discord server:
Don't worry about your members sharing this link: Only one Discord account can be connected per active member. So if a member did share their account login details with a friend and connect a new Discord account, that new account would connect but the existing account would be removed.
Important note: We recommend the "owner" of a Discord server is not also a member through Memberful. An admin, no matter the level, can never remove the owner of a Discord server, and this can lead to issues if the bot integration attempts to remove them.
We also recommend you don't change the permissions or roles assigned to the Memberful bot. This could risk breaking your integration.
Find a member by their Discord ID
You can search for a member by Discord ID in the Memberful dashboard.
The first step is getting the Discord ID of the user. If you haven't done this before, you can learn more about it here.
After copying the Discord ID, paste it into our search bar. The associated member will show up as the only result. If we can't find anyone and your server is public, it means the Discord user is not a member yet.
Related help docs:
Can't find what you're looking for? We'd love to help! 💪
Send us a message through the orange chat bubble in the lower right corner of the page. You'll hear back within a few hours Monday - Friday. 😀