[benecaster_subscriber_count]
Displays the current active subscriber count for a show. Designed for social proof placement on marketing or landing pages. Does not render if the count is below the minimum threshold (prevents showing low numbers that undercut credibility).
The count comes from Benecaster’s own record of who currently has access, not from your membership plugin. In practice the two agree; where they differ it is usually because somebody was added or removed on the membership side and the sync has not caught up yet.
Output is filterable via benecaster_subscriber_count_output.
Since this shortcode is most often placed on marketing pages (outside any show context), specifying show_id explicitly is recommended.
Parameters
| Name | Type | Default | Required | Description |
|---|---|---|---|---|
show_id |
int |
— | No | ID of the show to count. On single-show installs, may be omitted — the shortcode resolves to the only active show. On multi-show installs, required; renders nothing if omitted. |
tier |
string |
— | No | Restrict count to subscribers on a specific tier slug. Omit to count across all tiers. |
type |
string |
paying
|
No | Which subscribers to count. Options: paying (paid-tier only), total (paying + free tier), free (total minus paying). "Paying" is a deny list, not `token_type = 'subscriber'`: it counts any token type core doesn't exempt (`follower` today) on a non-free tier, including a custom type an add-on defines. `free` follows from the same definition — a non-standard, non-exempt token type on a paid tier counts as paying and is no longer included in `free`. |
format |
string |
full
|
No | Number format. Options: full (e.g. 1,247) or compact (e.g. 1.2k). |
minimum |
int |
10
|
No | Minimum count required to render. If actual count is below this threshold, the shortcode outputs nothing. |
label |
string |
— | No | Optional text appended after the number, e.g. 'active subscribers'. |
Example
<!-- Social proof badge, compact format, paying subscribers only -->
[benecaster_subscriber_count show_id="3" format="compact" label="subscribers"]
<!-- Only render if 50+ paying subscribers -->
[benecaster_subscriber_count show_id="3" minimum="50" label="people listening"]