# Discourse Patreon
**URL:** https://meta.discourse.org/t/discourse-patreon/44366
**Category:** Plugin
**Tags:** official, patreon, payments, included-in-core
**Created:** [May 17, 2016, 3:38am UTC](https://meta.discourse.org/t/discourse-patreon/44366 "2016-05-17T03:38:28Z")
**Posts on this page:** 5
**Page:** 1
### Author:  [@Discourse](https://meta.discourse.org/u/Discourse)
#### Post date: [May 17, 2016, 3:38am UTC](https://meta.discourse.org/t/discourse-patreon/44366/1 "2016-05-17T03:38:28Z")
| | | |
| --- | --- | --- |
| :discourse2: | **Summary** | **Discourse Patreon** enables Patreon Social Login, and synchronization between Discourse Groups and Patreon rewards. |
| š | **Install Guide** | **This plugin is bundled with Discourse core**. There is no need to install the plugin separately. |
> [@](#):
>
> :discourse2: As this is an #official plugin maintained by the Discourse team, #Support, #Contribute > Bug, #Contribute > UX, and #Contribute > Feature requests can be made in the respective categories here on Meta, and tagged with the appropriate plugin tag. Click on a link below to get one started. š
>
> [ā **Support**](https://meta.discourse.org/new-topic?category_id=6&body=%3E%20Before%20asking,%20did%20you%20search%20first%3F%20Press%20%F0%9F%94%8D%20at%20the%20upper%20right%20to%20search.&tags=patreon "Ask for support on configuring and using Discourse Patreon") [š **Bug**](https://meta.discourse.org/new-topic?category_id=1&tags=patreon "A bug report means something is broken, preventing normal/typical use of the plugin") [š **UX**](https://meta.discourse.org/new-topic?category_id=9&tags=patreon "Discussion about the user interface of Discourse Patreon, and how features are presented (including language and UI elements)") [š” **Feature**](https://meta.discourse.org/new-topic?category_id=2&tags=patreon "Discussion about how existing Discourse Patreon features can be improved or enhanced, and how proposed new features could work")
### Features
> ā Please note: Only members who have pledged to a tier membership will be synced to Discourse groups. [Free users](https://support.patreon.com/hc/en-us/articles/16433886029325-How-free-memberships-can-help-grow-your-community#h_01HBCDSFXEGMFMV8JSEY89JNYD) and users under the [Free trial](https://support.patreon.com/hc/en-us/articles/11044183172493-Free-Trials-FAQ) will not be synced to your Discourse groups.
> [@](#):
>
> ā¹ Do you run a popular Patreon project? Then you might be eligible for a free, hosted Discourse + SSL on our \ ***.discourse.group** domain. Read more at [Free Hosting for Patreon Creators.](https://blog.discourse.org/2018/12/free-hosting-for-patreon-creators/)
#### Social Login
This plugin will also enable a Social Login with Patreon, making it easier for your patron to sign up on Discourse.
### Configuration
> [@Configure Patreon integration with Discourse](https://meta.discourse.org/t/configuring-patreon-integration-with-discourse/62380):
>
> bookmark This guide explains how to set up and configure Patreon integration with your Discourse forum, including user synchronization, group management, and access control. person_raising_hand Required user level: Administrator warning Requires the Discourse Patreon plugin to be installed Summary This guide covers: Setting up Patreon API credentials Configuring the Discourse Patreon plugin Synchronizing Patreon users with Discourse groups Managing Patron group settings Setting up ā¦
### Settings
- See all relevant site settings by searching your admin settings for āpatreonā
| Name | Description |
| --- | --- |
| patreon enabled | Enable the discourse-patreon plugin |
| patreon login enabled | Enable Patreon Social Login |
| patreon client id | Generated Patreon Client ID |
| patreon client secret | Generated Patreon Client Secret |
| patreon webhook secret | Generated Patreon Webhook Secret |
| patreon creator discourse username | Username of the Discourse account which is used to login through Patreon creator account using āPatreon Social Loginā |
| patreon creator access token | Generated Patreon Creatorās Access Token |
| patreon creator refresh token | Generated Patreon Creatorās Refesh Token |
| patreon declined pledges grace period days | Grace period (in days) before a pledge is declined completely |
| max patreon api reqs per hr | Maximum number of Patreon API requests per hour |
| max patreon api reqs per day | Maximum number of Patreon API requests per day |
| patreon verbose log | enable verbose logging of patreon payload |
| patreon donation prompt enabled | Enable donation prompt? |
| patreon donation prompt show after topics | Show donation prompt after n topics |
| patreon donation prompt campaign url | Donation prompt campaign URL |
> :discourse2: Hosted by us? This plugin is available on [Pro, Business, and Enterprise hosting plans](https://www.discourse.org/pricing).
### Discourse users on Patreon
- QuarterToThree: [Forum](https://forum.quartertothree.com/) | [Patreon](https://www.patreon.com/tomchick)
- UM Hoops - [Forum](http://forum.umhoops.com/) | [Patreon](https://www.patreon.com/umhoops)
- DrownedInSound - [Forum](https://community.drownedinsound.com/) | [Patreon](https://www.patreon.com/drownedinsound)
> Last edited by @tobiaseigen 2025-10-25T15:24:14Z
>
> > **Check document**
> >
> > Perform check on document:
---
### Author:  [@pfaffman](https://meta.discourse.org/u/pfaffman)
#### Post date: [December 15, 2023, 12:25pm UTC](https://meta.discourse.org/t/discourse-patreon/44366/180 "2023-12-15T12:25:39Z")
Looks like thereās a bug: [Blank topics after log-in (Patreon cookies) - #3 by Arkshine](https://meta.discourse.org/t/blank-topics-after-log-in/288800/3)
---
### Author:  [@tvavrda](https://meta.discourse.org/u/tvavrda)
#### Post date: [February 14, 2025, 1:08pm UTC](https://meta.discourse.org/t/discourse-patreon/44366/181 "2025-02-14T13:08:55Z")
> EDIT: As I realized I could edit the Wiki myself, I just did.
I am sorry but almost none of the examples work or use Patreon. The only ones that do are:
- QuarterToThree
- UM Hoops
- DrownedInSound
For the rest:
> [@Discourse](#):
>
> Mastodon - [Forum](https://discourse.joinmastodon.org/) | [Patreon](https://www.patreon.com/mastodon)
They use GitHub.
> [@Discourse](#):
>
> Fantasy Footballers - [Forum](https://community.thefantasyfootballers.com/) | [Patreon](https://www.patreon.com/thefantasyfootballers)
They use Discord
> [@Discourse](#):
>
> Redox OS - [Forum](https://discourse.redox-os.org/) | [Patreon](https://www.patreon.com/redox_os)
Doesnāt work
> [@Discourse](#):
>
> The Bitcoin Pub - [Forum](https://thebitcoin.pub/) | [Patreon](https://www.patreon.com/pub)
They use XenForo
> [@Discourse](#):
>
> CommonDreams - [Forum](https://commons.commondreams.org/) | [Patreon](https://www.patreon.com/Stephen)
Not using Patreon, still on Discourse
> [@Discourse](#):
>
> - Fun Fun Function - [Forum](https://www.funfunforum.com/) (private) | [Forum](https://www.patreon.com/funfunfunction)
> - Tim from Video Creators - [Forum](https://patrons.videocreators.com) (private) | [Patreon](https://www.patreon.com/videocreators)
These seem not to be working.
> [@Discourse](#):
>
> [Strats.co](http://Strats.co) - [Forum](https://forum.strats.co/) | [Patreon](https://patreon.com/stratsco)
They use Discord
---
### Author:  [@tobiaseigen](https://meta.discourse.org/u/tobiaseigen)
#### Post date: [July 16, 2025, 9:42pm UTC](https://meta.discourse.org/t/discourse-patreon/44366/182 "2025-07-16T21:42:50Z")
š„³ This plugin is now bundled with Discourse core as part of [Bundling more popular plugins with Discourse core](https://meta.discourse.org/t/bundling-more-popular-plugins-with-discourse-core/373574). If you are self-hosting and use the plugin, you need to remove it from your `app.yml` before your next upgrade.
---
### Author:  [@Cla](https://meta.discourse.org/u/Cla)
#### Post date: [March 2, 2026, 6:16pm UTC](https://meta.discourse.org/t/discourse-patreon/44366/185 "2026-03-02T18:16:07Z")
Patreon is discontinuing the APIs v1, is the plugin already updated to use the new V2 APIs?
> **[Introduction - API Reference](https://docs.patreon.com/#introduction)**
>
> Get familiar with the Patreon API and tools using the tutorials and references below.