Skip to main content

Email Directory — Every Email Benecaster Sends

A single table of every email Benecaster’s own WordPress site can send — what triggers it, the template file that renders it, and where to read more. This is a directory, not a replacement for the pages it links to: Automated Emails explains each one for a podcaster audience, Email Types Reference covers the filter and action hook families that target them, and Billing Emails covers the five built-in membership templates in full, including default copy.

Scope: emails sent by your own site only. Every row below is dispatched by the plugin’s own EmailQueue, through your own SMTP connection. It does not include emails benecaster.com sends you directly about your account (threshold warnings, plan changes, payment-failure notices) — those never pass through your site and have no template file to override. See the “Emails Benecaster Sends You From benecaster.com” section of Automated Emails for that list. It also excludes add-on-only email types (broadcast, episode_notification, the analytics_digest_* family) — see Email Types Reference for those.

Subscriber Emails

Email Type string Sent when Template file Related docs
Welcome welcome A subscriber’s feed token is generated for the first time templates/emails/welcome.php How Feed Tokens Work
Token Reset token_reset An admin resets a feed token with Reset and send email (a subscriber’s own reset shows the new URL on the account page and sends nothing) templates/emails/token-reset.php Token Reset
Feed Link feed_link A podcaster presses Email link on a subscriber’s panel to re-send the feed URL they already have templates/emails/feed-link.php Subscribers REST API
Tier Change tier_change A subscriber’s tier is updated — upgrade, downgrade, admin change, or a scheduled plan change landing. Names the plan they left and the plan they moved to, on membership-plugin and Built-in Membership shows alike templates/emails/tier-change.php How Subscriber Limits Work
Donation Thank-You donation_thank_you A Listener Support donation is logged and a donor email address is available templates/emails/donation-thank-you.php Setting Up Listener Support (Stripe Mode)

Welcome, Token Reset and Tier Change can each be switched off per show, at Benecaster → Shows → [show] → Subscription → Welcome and Feed URL Emails (works under any bridge). A switched-off email is never built, so it never reaches the benecaster_email_should_send filter. The Welcome switch is the one exception that never fully applies — it never stops a follower’s welcome email, since that’s a follower’s only route to their feed URL (operator ruling). Donation Thank-You has no per-show switch.

Feed Link and Token Reset both carry a feed URL, and they do opposite things. Feed Link resets nothing: it re-sends the URL already in the subscriber’s podcast app, so the app keeps working. Token Reset follows a reset: the old URL has stopped working and the subscriber has to set the podcast up in their app again. Feed Link has no per-show switch, because it is only sent when a podcaster asks for it, and subscribers cannot unsubscribe from it.

Built-in Membership Billing Emails

Email Type string Sent when Template file Related docs
Subscription Receipt subscription_receipt A built-in membership payment is confirmed by Stripe — initial activation and every renewal templates/emails/subscription-receipt.php Built-in Membership Billing Emails
Renewal Reminder renewal_reminder A configurable number of days before a built-in membership subscriber’s renewal (default 7) templates/emails/renewal-reminder.php Built-in Membership Billing Emails
Payment Failed payment_failed The first time Stripe fails to charge a built-in membership renewal — not on every retry templates/emails/payment-failed.php Built-in Membership Billing Emails
Cancellation Confirmation cancellation_confirmation A built-in membership subscriber requests cancellation through their account page templates/emails/cancellation-confirmation.php Built-in Membership Billing Emails
Subscription Cancelled subscription_cancelled A built-in membership subscription reaches a terminal cancelled state templates/emails/subscription-cancelled.php Built-in Membership Billing Emails
Price Change Notice price_change_notice A tier or buy-up price change with Move is saved — the notice itself, to every subscriber it applies to templates/emails/price-change-notice.php Built-in Membership Billing Emails
Price Change Reminder price_change_reminder Optional; a configurable number of days before a subscriber’s first renewal at a new price templates/emails/price-change-reminder.php Built-in Membership Billing Emails
Price Change Cancelled price_change_cancelled A pending price change is cancelled before its notice period ends templates/emails/price-change-cancelled.php Built-in Membership Billing Emails
Billing Change Scheduled cadence_switch_scheduled A built-in membership subscriber schedules a self-service switch to another billing period of their tier templates/emails/cadence-switch-scheduled.php Built-in Membership Billing Emails
Plan Change Scheduled tier_switch_scheduled A built-in membership subscriber schedules a move down, or to a tier at the same price. Tier Change follows when the move lands. Not sent for an upgrade, which lands at once and sends only Tier Change templates/emails/tier-switch-scheduled.php Built-in Membership Billing Emails
Move to Free Plan Scheduled free_tier_switch_scheduled A built-in membership subscriber chooses the show’s free plan from their account page. Tier Change follows when the move lands; Subscription Cancelled is never sent for it templates/emails/free-tier-switch-scheduled.php Built-in Membership Billing Emails

The five above (Subscription Receipt through Subscription Cancelled) can each be switched off per show, at the same Subscription tab’s Subscriber Billing Emails section. Same rule: a switched-off email is never built. Billing Change Scheduled, Plan Change Scheduled and Move to Free Plan Scheduled have no per-show switch.

Of the three price-change emails, only the reminder has a switch — price_change_notice and price_change_cancelled always send, because they are the notice itself. All three are transactional, in UnsubscribeManager::TRANSACTIONAL_TYPES — as are Billing Change Scheduled (cadence_switch_scheduled), Plan Change Scheduled (tier_switch_scheduled) and Move to Free Plan Scheduled (free_tier_switch_scheduled): each describes the subscriber’s own billing, so a marketing opt-out does not stop it.

Promote to Bridge Emails

Email Type string Sent when Template file Related docs
Promote Grace Reminder promote_grace_reminder About 7 days before a promote-to-bridge grace period expires templates/emails/promote-grace-reminder.php Promote to Bridge — Grace Period
Promote Grace Expired promote_grace_expired A promote-to-bridge grace period elapses without re-authorization templates/emails/promote-grace-expired.php Promote to Bridge — Grace Period

Account Provisioning Emails

These support the follower and guest signup flows, plus one account-identity change outside signup. None of them get a per-show on/off toggle. Guest — Set Password, Already Following, and Email Verification ARE registered in EmailTypeRegistry (with unsubscribable: false), so they appear in the Email Editor add-on’s template manager — registration just isn’t wired to a settings-page toggle yet. Follower — Confirm Signup is the one exception: it’s dispatched the same way, through EmailManager::send(), so the filter families above still work on it, but it has no EmailTypeRegistry entry and so doesn’t surface in the Email Editor’s list. All four can be overridden with the standard PHP template override system regardless.

Email Type string Sent when Template file Related docs
Guest — Set Password guest_password_set A WordPress account is created for someone rather than by them: bulk enrollment, a subscriber added by hand, or a completed donation. Not sent for [benecaster_subscribe] signups, where the subscriber sets a password on the form templates/emails/guest-password-set.php Customizing Email Templates
Already Following already_following Someone submits the follower signup form with an address that already follows the show templates/emails/already-following.php Free Followers
Follower — Confirm Signup follower_confirm The double opt-in step of a new follower signup, sent before a token is created — the link both confirms the address and completes signup templates/emails/confirm-follower-signup.php Free Followers
Email Verification email_verification A subscriber changes their email address on the account page — sent to the new address with a single-use link that promotes it; the old address stays active until the link is clicked templates/emails/verify-email.php Your Account Page

Data Request Emails

Privacy requests from people who may have no account on your site. donor_data_erasure goes to a Listener Support donor who asks, by email address, for their details to be removed. It is sent only if donations exist on that address, and the request’s response never says whether they do. The link is single-use and expires after 24 hours. Confirming it anonymises every donation on that address (name, email, message and Stripe customer cleared, amounts kept) rather than deleting the rows.

Email Type string Sent when Template file Related docs
Donor Data Erasure — Confirm donor_data_erasure A donor asks for their details to be removed from their donations; the link confirms the request before anything is removed templates/emails/donor-data-erasure.php Exporting Your Data

See Also

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