Email Editor Overview
The Email Editor add-on lets you design the emails Benecaster sends without touching a template file, and send one-off messages to your listeners. You work in blocks: add them, drag them into order and type your own wording.
Buy it from 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 Email Editor card → Active on.
Switching it on changes no email. Your emails keep going out as they do now until you save a design or branding. An email you never touch keeps following Benecaster’s own template, or your theme’s override if you have one.
Where It Is
While Email Editor is on for at least one show, Email Editor appears in the left menu of the Benecaster admin. On a show where it is off, you see a notice instead. It has these tabs:
- Templates lists every email you can design. See Managing Templates.
- Settings sets the colors, font, logo, header and footer around every email from this show. See Branding.
- Broadcasts sends a one-off email to your listeners. See Sending Broadcasts.
- Episode Notifications emails listeners when a new episode is available to them. See Episode Notifications.
- Link tracking sets the UTM tags on the links in this show’s broadcasts and episode notifications: Medium (utm_medium), Broadcast campaign (utm_campaign) and Episode notification campaign (utm_campaign).
- Logs lists every email Benecaster was asked to send for this show and what became of it. See The Logs Tab.
Each Show Has Its Own Designs
Each show has its own templates and branding. A show with nothing saved for an email sends Benecaster’s template or your theme’s override, never another show’s design.
Some email goes out with no show attached, such as email address verification. Design email sent with no show, on the Templates tab, and Brand email sent with no show, on the Settings tab, open a separate site-wide design for those. It’s used whenever the add-on is on for at least one show.
A show with Email Editor switched off sends Benecaster’s templates. Its designs are kept, and come back when you switch it on again.
The Logs Tab
When a listener says an email never arrived, Logs is where to look. It’s the last tab, after Link tracking, and it’s on a show only: it lists every email Benecaster was asked to send for the show the screen is on, newest first. To see another show’s email, switch to that show. Email sent with no show, such as an email address check, isn’t listed, and the tab says so.
Each row shows Date (in your site’s time zone and formats), Type, To, Subject, Status and Actions.
What Each Status Means
| Status | What it means |
|---|---|
| Sent | Handed to your email sender. That’s as far as Benecaster can see, so for a Sent email that never arrived, check your SMTP setup. |
| Sending… | Waiting in Benecaster’s queue, not handed over yet. |
| Failed | It couldn’t be sent. The error is shown under the status. |
| Not sent | Benecaster stopped it, and says why under the status (see below). |
| Test | A test send or a review copy. |
| Held on this site | Waiting on a copy of your live site. See On a Copy of Your Site. |
| Dropped unsent | Held on a copy of your live site for three days, then dropped. |
A Not sent email gives one of four reasons:
- They unsubscribed from all email from this show.
- They opted out of announcements.
- They opted out of episode notifications.
- Stopped by a setting or another plugin.
Finding an Email
The filters sit under Show emails:
- Type: All types, or one of the emails on the Templates tab.
- From and To: whole days, in your site’s time zone.
- Sent to: one listener’s email. See Searching by Address.
Type, From and To apply as soon as you change them. Clear filters appears once any filter is set, and empties them all, Sent to included. If the tab can’t use a filter, it shows why in place of the list, such as The From date is after the To date.
The log shows 50 emails a page, with Previous and Next to move between pages.
Benecaster keeps the email log, and its copy of each email, for 180 days by default, then deletes them. If your site keeps them for less than 90 days, the tab says so: Benecaster keeps this log for N days, so older emails are not listed.
Searching by Address
Type a listener’s whole email address in Sent to, then click Search or press Enter. Typing alone doesn’t search. The tab lists that listener’s email for this show only, still narrowed by Type and the dates.
Sent to finds the listener’s account, not matching text. Benecaster looks up whose account has that address now and lists everything sent to them. So:
- Email sent before they changed their address is found from the new address, and its To column still shows the old one.
- Their old address finds nothing.
- An address with no account on this site finds nothing, even if Benecaster has emailed it. Find that email by Type and date instead.
- A partial address is refused: Enter the whole email address, such as name@example.com.
On a Copy of Your Site
On a staging site or another copy of your live site, Benecaster doesn’t email your listeners, so nobody on your list hears from a copy. Email it would have sent shows as Held on this site, with this note: This site looks like a copy of your live site, so Benecaster does not email your listeners from it. It is sent if this site is declared live within three days, and dropped unsent after that.
Three days on, it shows as Dropped unsent: It waited three days on a copy of your live site and was dropped unsent. Test sends and review copies still go out. If this really is your live site at a new address, see Testing with a Staging Site.
Resending an Email
Resend, in the Actions column, sends an account or billing email again, exactly as it went out, to the same address. Use it when a listener has lost a receipt or never got their feed link.
It’s offered only on an email a listener can’t opt out of, with the status Sent or Failed, that Benecaster still has its copy of. Broadcasts and episode notifications can’t be resent here, and neither can an email that is Sending…, Not sent, Test, Held on this site or Dropped unsent.
Benecaster asks first: Send “SUBJECT” to ADDRESS again, exactly as it went out? Once you confirm, it shows Queued again. It is listed at the top of this log. and reloads the list. If Benecaster won’t send it, the reason appears under the button instead, such as The recipient has unsubscribed from this email since it was sent.
A line above the filters says how far back Resend reaches: Resend sends an account or billing email again, exactly as it went out, from the copy Benecaster keeps for N days. Links in it are the same, so one that has expired since will not work. On a site that keeps its email log forever, it leaves out for N days.
Sending Yourself a Review Copy
Send me a review copy, in the Actions column, emails you the email as the listener got it, so you can see how it looked. It goes to you, the administrator who clicked, never to the listener, with [Review copy] in front of the subject. It’s offered on any email Benecaster still has its copy of, whatever its type or status, held email included.
Its links are the listener’s, and they work. A sign-in link in it signs you in as that listener, and an unsubscribe link unsubscribes them. Look, but don’t click.
The tab says so above the filters: Send me a review copy sends the email to you, not the listener, so you can see how it looked. Its links are the listener’s and they work: its sign-in link signs you in as them, and its unsubscribe link unsubscribes them. Look, but do not click. The confirm repeats it before anything is sent, and afterwards the row shows A review copy is on its way to ADDRESS.
A review copy is logged as Test, so it goes out on a copy of your site too. The original isn’t touched: held email stays held, and the listener gets nothing.
What Comes With It
- The merge tag library, which offers the tags each email can use as you type.
- Preview and test send, including with your unsaved edits.
- Earlier versions of every design, and Reset to default.
- Import and export of a show’s designs.
- Data export sheets for your broadcast history and opt-out list.
- Open and click counts for broadcasts and episode notifications, shown by the Analytics Dashboard add-on. Without it, the Episode Notifications and Broadcasts tabs show a box headed Open and click rates pointing to it, and a notice in the notifications bell, See who opens your episode emails, does the same until you dismiss it.
The Tour
Email Editor Tour is offered once Email Editor is on for one of your shows. It shows you the list of emails, the canvas, the merge tags, the episode notifications switch and the test send, and skips any show where the add-on is off.
Deleting the Add-on
Deleting the plugin removes its designs only when Benecaster’s Delete all data on uninstall is on. Otherwise they stay, and return if you install it again.
With Podcast Workflow
On a show that also has Podcast Workflow, the Workbench’s Subscriber notification tile (off until you turn it on in the show’s Workflow settings) shows what will be emailed to listeners about each episode. The choice is made in the Ready to Publish? dialog when the episode is first published, so until then the tile reads Chosen when the episode is published. Afterwards it reads Using the notification template, Composed for this episode or No notification.
For Developers
Code examples are in the recipe library:
See Also
Need this built rather than just documented? See our services →
Last updated