Integrate with Discourse
Discourse is a popular and powerful open source discussion forum software. Memberful integrates directly with Discourse, making it easy to create a members-only discussion forum. In this article, we'll walk you through the steps to integrate your Discourse forum with Memberful.
If you're new to Discourse, read the official Discourse install tutorial to get started.
In this help doc:
- Create a Discourse Group.
- Generate an API Key.
- Integrate Memberful with Discourse.
- Configure Memberful’s Discourse settings.
- Protect your Discourse Categories.
- Disallow anonymous access (optional).
- Set up Discourse admins.
- Add a signup link to your forum.
- Disable Discourse integration.
Create a Discourse Group
In Discourse, navigate to Groups via the menu icon.
Click New Group.
Name and save your Group.
Generate an API Key
In Discourse, generate an API Key via Admin → API.
Integrate Memberful with Discourse
Navigate to Content → Community → Discourse in your Memberful dashboard, and click Connect.
Enter information about your Discourse site including the API key you just generated. The Username and Email must be for the Discourse admin.
Now you're connected!
Advanced: Discourse Settings
When Memberful connects to Discourse it changes some of your default Discourse settings. A list of those changed settings is below.
Settings → Login
enable discourse connect:
On (Formerly "enable_sso")enable discourse connect provider:
Off (Formerly "enable sso provider")discourse connect url:
Set by Memberful (Formerly "sso url")discourse connect secret:
Set by Memberful (Formerly "sso secret")auth overrides email:
On (Formerly "sso overrides email")auth overrides name:
On (Formerly "sso overrides name")
Settings → Users
email editable:
Off
Settings → Posting
display name on posts:
On
Settings → Plugins
disable discourse narrative bot welcome post:
On
Configure Memberful’s Discourse settings
To limit access to specific Discourse categories based on your members' plans:
- Go to Content → Community → Discourse.
- Click Edit settings.
- Choose which membership plans should be linked to which Discourse groups.
- When you're finished, click Update settings to save your changes.
Keep in mind that these setting doesn’t apply to members who registered for free.
Once everything is set up, active members will automatically be added to their assigned Discourse group after they sign in through Memberful.
If a member's subscription expires, they'll be removed from the associated Discourse group — even if they still have a Discourse account.
Protect your Discourse Categories
To leverage the Discourse Groups you've set up, you'll need to change the security settings on your Discourse Categories.
Click a Discourse Category and then click the edit Wrench icon.
Navigate to the Security settings, click Add a group and select the Discourse Group.
After choosing your new Discourse Group, select the See / Reply / Create settings and click the Save Category to add this security setting.
Repeat the process for all other members-only Categories.
Disable default categories
Default Discourse categories like Meta don't have security settings. If you want a "members-only" forum, don't use the default categories.
Disable posting to Uncategorized
You'll notice that the Uncategorized Category does not have a Security tab. You can disable posting to the Uncategorized Category by visiting Admin → Settings → Posting.
Disallow anonymous access
If you're running a protected Discourse forum, we also recommend disallowing anonymous access from Settings → Login.
Keep in mind, if you disallow anonymous access, all members will need to sign in to Memberful to view your forum.
Set up Discourse admins
We have a security setting that doesn't allow Memberful non-admins to be Discourse admins. This is necessary because we don't confirm email address ownership. The solution is to create your Discourse admins as Memberful staff. Navigate to Settings → Staff from your Memberful dashboard to set up staff.
Access the forum as an admin
We use the member login page for SSO since the vast majority of Discourse users are members. If you want to access your Discourse forum as an admin, make sure to sign in to your Memberful dashboard first.
Make a paying member a moderator
If you set a paying member as a Discourse admin, we will remove the admin flag the next time we sync the member. This is to protect your Discourse admin account. However, we don't touch the Moderator flag, so your paying members can be Discourse moderators.
Add a signup link to your forum
When SSO is enabled, Discourse will show a login button but no signup button. To add a signup link to your Discourse discussion forum, create a Memberful plan, copy the plan purchase link, and add it to your website or forum. Or customize your Discourse header to include the link.
Disable Discourse integration
When you disable our Discourse integration, we try to disable Memberful Single Sign On (SSO) on your forum. Once the integration is successfully disabled, you (and your members) will be able to log in to the forum normally.
If you are unable to log in to your forum after you've disabled our integration, log in via this URL to fix your Discourse settings:
https://forum.yoursite.com/u/admin-login
Related help doc:

Can't find what you're looking for?
We'd love to help! You'll hear back within a few hours Monday–Friday.