Skip to main content

Community Integrations Overview

Required add-on: Community Integrations

The Community Integrations add-on keeps a show’s Discord server or Circle community in step with its tiers. You choose which Discord roles or Circle spaces each tier gets. When someone subscribes, they get them. When they move to another tier, their access moves with them. When they leave, it is taken away. You stop managing community access by hand alongside your subscriptions.

One add-on covers both platforms. A show can use Discord, Circle or both, and each of your shows connects its own server or community.

Community Integrations costs $49 a year and works on every Benecaster plan, Launch included. See its shop page. Install it like any other add-on (see Installing Add-ons), and switch it on for the shows you want under Benecaster → Settings → Add-ons → the Community Integrations card → Active on.

Discord or Circle?

Discord Circle
What a tier gets Roles on your server Spaces in your community, and optionally member tags
What you connect A Discord application and its bot An Admin API key and your community’s address
Matching subscribers Each subscriber clicks Connect Discord on their account page, once per show By email address, with nothing for the subscriber to do
Joining Connect Discord adds them to your server Circle sends its own invitation
What you need A server you manage A Circle plan that includes Admin API access

Setup for each is on its own page: Discord Setup Guide and Circle Setup Guide.

Tiers Only, Never Buy-ups

Community access follows a subscriber’s tier and nothing else. A buy-up gives no Discord role and no Circle space, even one you named “Discord access”. Free followers have no tier, so they get nothing either.

A subscriber gets their tier’s access while they hold an active membership on that tier. Someone imported by the Migration Wizard who has not paid yet gets nothing until they do. If you want a buy-up to open part of your community, that is custom development: your own code checks the buy-up and calls the platform.

The Community Tab

Each show’s connection lives on its own settings. Go to Benecaster → Shows, click Settings on the show’s card, and choose Community. The tab appears only on a show where Community Integrations is switched on. It has three parts.

Community platforms holds a Discord panel and a Circle panel. Each starts at Not set up for this show. and reads Connected to {name}. once it works. The setup guides walk through each panel.

Member sync shows how the show’s members stand:

  • Last synced: {date and time}, in your site’s date format and time zone, or Nothing has synced on this show yet.
  • In step: N · Retrying: N · Failed: N, counting each member once per platform.
  • Up to 20 problems, newest first, each as {name} <{email}> on {platform} — Retrying: {reason} ({date and time}), or Failed: once retries are used up. The reason is the platform’s own answer, in words.
  • Resync now, which Checks every member of this show against each platform and fixes any difference, in the background. It confirms with Resync queued. Members are updated in the background over the next few minutes.

Merge tags lists the add-on’s two tags, each with Copy. See Merge Tags below.

How Members Are Kept in Step

Every change happens in the background, never during checkout, usually within a few minutes.

  • Subscribing. The subscriber gets what their tier is mapped to: Discord roles once they have connected Discord, or Circle spaces and tags straight away.
  • Changing tier. Only what differs between the old tier and the new one is added or taken away.
  • Leaving every mapped tier. What the add-on gave is taken away. Each platform then has a choice of its own: Discord can also give a former-subscriber role or remove them from the server, and Circle can also remove them from the community. Both are off unless you choose them.
  • Coming back. A returning subscriber gets their tier’s access again.
  • Changing your mapping. Saving a changed role, space or member tag choice updates every member already on that platform, in the background.

Only what the add-on gave is ever taken away. A Discord role or Circle space you gave someone by hand stays.

If a platform refuses or can’t be reached, that member is tried again after 1 minute, 5 minutes, 30 minutes, 2 hours and 12 hours. After that they show as Failed under Member sync until their membership next changes or you click Resync now. When a platform asks Benecaster to slow down, the member waits as long as the platform asks, and that doesn’t count as a failed try.

Switching Off and Back On

Switching Community Integrations off for a show removes nobody. Roles and spaces stay where they are, and nothing new is given on that show while it is off. Someone who drops below a mapped tier still loses that role or space while the add-on is switched on for any other show.

Switching the show back on resyncs every member of the show: people who joined while it was off get their access, and people who left lose theirs.

If your licence stops covering Community Integrations, or the add-on is switched off on every show, nothing syncs at all and everyone keeps what they have. Erasure requests are the exception: see Privacy below. Once the add-on is running again, use Resync now on each show to catch up.

Merge Tags

Both tags work in any Benecaster email, such as the welcome email, while Community Integrations is switched on for the show the email belongs to, and each takes its value from that show.

Tag What it inserts Empty when
{{discord_invite_url}} The show’s Discord Invite link The show has no Discord server connected or no invite link saved
{{circle_community_url}} The show’s Circle Community URL The show has no Circle community connected

Only use them in emails from shows the add-on is switched on for.

A tag belongs to the show, not the reader: every email the show sends carries it, whatever the reader’s tier. See Customizing Emails for where merge tags go.

What Subscribers See

On the account page, a show’s card ends with a Community section when there is something to show:

  • Discord, when the show is connected to a Discord server and the subscriber’s tier gets at least one role: Connect Discord or Disconnect Discord, and Join the Discord server. See What Subscribers See in the Discord guide.
  • Circle, when the show is connected to Circle and the subscriber’s tier is mapped to at least one space: Your membership includes this show’s community on Circle. and an Access your community link, which opens the community in a new tab.

A card with neither has no Community section. Someone whose subscription has ended has no card for that show, so they see nothing from this add-on.

Setup Wizard Steps

The add-on adds two steps to Benecaster’s setup wizard, Connect your Discord server and Connect your Circle community, each with I’ll set this up in Settings. to skip it. If you install the add-on after finishing setup, each show it’s switched on for is offered the steps it still needs through Setup Steps From Add-ons You Install Later. Connecting the platform on the show’s Community tab takes its step back. Either way, roles and spaces for each tier are chosen on the Community tab.

Privacy

Discord receives the Discord account a subscriber connects, and Circle receives their email address and tier. When you delete a subscriber’s data, delete their WordPress account, or complete their request under Tools → Erase Personal Data, and when Benecaster’s data retention deletes them, they are taken out of the roles, spaces and tags the add-on gave on every show. This works even while the add-on is switched off for every show or its licence has lapsed, but not while it is deactivated on the Plugins screen. Tools → Export Personal Data lists what each show’s Discord server and Circle community were given. While Discord or Circle is in use, Settings → Privacy → Policy Guide carries a Community Platforms section. Privacy and Data Handling has the detail.

Deactivating and Deleting

Deactivating the add-on on the Plugins screen deletes nothing and removes nobody, but while it is deactivated no erasure reaches Discord or Circle. Remove the person there by hand.

Deleting the add-on from Plugins deletes every show’s saved Discord bot token, Discord Client Secret and Circle API key. Nobody is removed from Discord or Circle. The add-on’s record of who it gave what stays on your site until Benecaster’s own data is deleted (uninstalling Benecaster with data removal on, or Reset Plugin Data).

For Developers

See Also

Need this built rather than just documented? See our services →

Last updated