Skip to main content

Episode Notifications

Required add-on: Email Editor

Episode notifications email a show’s listeners when a new episode is available to them. Each email is the Episode notification template from the Templates tab, filled in with that episode’s details for each listener. Listeners can opt out of episode notifications on their own without opting out of broadcasts.

Switching Them On

Open the show’s Email Editor screen and choose the Episode Notifications tab, between Broadcasts and Link tracking. It isn’t on the site-wide design.

Tick Send episode notifications for this show. They’re off until you do. While you switch them on, the tab estimates how many emails a week each listener will get, from the episodes the show published over the last 12 weeks. A listener who follows several of your shows gets each show’s notifications, so it adds up.

Then choose:

Setting Options
When to send When each tier can listen (per-tier release) (the default) or Everyone at publish (simultaneous teaser)
What to send The notification template (the default) or Write one for each episode
Start playing when a listener clicks the player card Off by default

Click Save. The settings are kept if you switch the add-on off for the show, and removed with the show.

When Each Listener Is Emailed

Per-tier release. Each tier is emailed when the episode becomes available to it, so your release schedule decides who hears first. Holders of a buy-up the episode requires are emailed when it becomes available to them. Followers are emailed when the episode becomes available to everyone; for an episode that’s public as soon as it’s published, that’s the moment you publish.

Simultaneous teaser. Everyone with a feed on the show is emailed about a minute after you publish. Listeners who can’t hear the episode yet get a teaser instead: it says which subscribers can listen now and invites them to upgrade, with See how to listen in place of Listen now.

Each listener gets one email per episode, however many of their tiers it reaches, and republishing doesn’t send it again. Only new episodes are announced: an episode counts as new if it opened, or was published, within the last seven days, so publishing an old imported draft today sends nothing.

A notification stops if you unpublish the episode or switch notifications or the add-on off for the show. One still unfinished three days after it started sends nothing more.

Writing One Email for an Episode

When you publish, Benecaster’s Ready to Publish? dialog has an Episode notification section, What to email listeners about this episode:

  • Send the notification template
  • Write this episode’s email — starts from the show’s notification template, with its blocks and conditions, and a Subject that keeps the template’s when you leave it empty
  • Don’t send a notification for this episode

With What to send set to Write one for each episode, the section opens on writing; otherwise it opens on the template. Your choice is kept from the episode’s first publish and applies to every tier, including those it opens to later. Don’t send… cancels them all. Clicking Cancel in the dialog drops what you wrote.

The section doesn’t appear when you update an episode that’s already published, or on a show without notifications on.

What the Email Holds

The starting design shows the episode’s player card, its title, the show’s name, the episode’s guests, the start of the episode’s description, Listen now, Listen in your podcast app, the episode’s references, and an invitation to share the show. Edit it like any template on the Templates tab.

  • The player card is the episode’s artwork (the show’s when the episode has none) as a wide strip with a play button over it, linked to the episode. It can only be drawn for a published episode with artwork; otherwise the design shows the plain artwork.
  • Listen now and the player card use each listener’s own link to the episode, which signs them in to hear it. A listener who can’t listen yet gets the episode’s page instead.
  • The episode’s guests, with the Guest Manager add-on on for the show, appear as Featuring Alice Smith and Bob Jones right after the show’s name, in the order you set on the episode. An episode with no guests leaves the line out. A design you saved before this line existed keeps its blocks as they are: add the line yourself from the tag list, with the Episode guests tag.
  • The episode’s references are the links you added to the episode, under a References heading, as its feed item shows them. They sit after the listening buttons and before Enjoying this show? Pass it on. They’re filled in for each listener as the email is sent, so a reference you edit after saving the design still reaches the email. A listener who can’t hear the episode yet gets none, and an episode with no references leaves the block out. The tag is {{episode_references}}; a preview shows two sample links, A study of people who work nights and Our guest’s website.
  • Starting playback: with Start playing when a listener clicks the player card on, the episode page tries to start the player when someone arrives from the card. Browsers often refuse until someone has used your site before, and then a Click to play button shows instead. You can change this for one episode in Ready to Publish? (Clicking the player card).

The tags that fill these in are listed in the Merge Tag Library.

Episode notifications and broadcasts carry a tracking pixel, so you can see how many listeners open them, and every web link goes through a short redirect on your site that counts the click and then sends the reader on to the address exactly as written. Unsubscribe links, mailto: links and links within the email aren’t redirected. A preview or test send records nothing.

Open rates may be inflated: Apple Mail (iOS 15 and later) fetches tracking pixels before the subscriber reads the email. This is a known limitation of open tracking on every platform.

The rates themselves appear in the Analytics Dashboard add-on. Without it, the Episode Notifications and Broadcasts tabs show a box headed Open and click rates pointing to it.

After a license lapse, or with the Email Editor switched off for the show, emails already delivered keep working: the player card still shows and links still take readers where they lead. Nothing is recorded until the add-on is running for the show again.

Links carry UTM tags, set per show on the Link tracking tab: Medium (utm_medium), Broadcast campaign (utm_campaign) and Episode notification campaign (utm_campaign).

What Is Kept About Listeners

For each listener, the Email Editor keeps which emails they were sent, when they first and last opened each and how many times, each link they clicked with its times and count, and which episodes they were notified about. It keeps no IP address and no browser details. Open and click records are deleted after 730 days, and notification records 30 days after the notification finishes; all of it goes when the listener’s account or the show is deleted.

WordPress’s Tools → Export Personal Data includes it under Benecaster Email Editor, and Tools → Erase Personal Data deletes all of it. See GDPR and Privacy.

For Developers

Recipes 278 to 282 cover the settings hooks, who gets a notification, the per-episode choice, the player card’s look and the engagement reader, benecaster_email_editor_get_engagement().

See Also

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

Last updated