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
| 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 |
A feed token is reset, by admin or by the subscriber | templates/emails/token-reset.php |
Token Reset |
| Tier Change | tier_change |
A subscriber’s tier is updated — upgrade, downgrade, or admin change | 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.
Built-in Membership Billing Emails
| 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 |
All five can be switched off per show, at the same Subscription tab’s Subscriber Billing Emails section. Same rule: a switched-off email is never built.
Buy-up price migrated has no admin control at all — it exists only as show meta (_benecaster_show_email_buyup_price_migrated_enabled), with no on/off UI anywhere.
Promote to Bridge Emails
| 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 are sent by the follower and guest signup flows. Unlike every other row on this page, they are not registered in EmailTypeRegistry — they don’t get a per-show on/off toggle at all (unlike Welcome, Token Reset and Tier Change above), and they don’t appear in the Email Editor add-on’s template manager. They can still be overridden with the standard PHP template override system.
| Type string | Sent when | Template file | Related docs | |
|---|---|---|---|---|
| Guest — Set Password | guest_password_set |
A logged-out visitor subscribes through [benecaster_subscribe] and a WordPress account is created for them on the fly |
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 |
Data Request Emails
| Type string | Sent when | Template file | Related docs | |
|---|---|---|---|---|
| Donor Data Erasure — Confirm | donor_data_erasure |
A donor requests deletion of their donation records; the link confirms the request before anything is deleted | templates/emails/donor-data-erasure.php |
Exporting Your Data |