Skip to main content

Merge Tag Library

Required add-on: Email Editor

A merge tag is a {{double-brace}} placeholder that Benecaster fills in for each reader. The Email Editor offers only the tags the email you’re designing can use, so you never have to guess a name.

Two Ways to Add One

Type {{ in Subject, a Text block, or a block’s text or address field. A list opens with each tag and what it outputs. Arrow keys and Enter or Tab pick one, and Escape closes the list.

Merge tags this email can use, on the email’s page, lists the same tags with descriptions, and is open by default. Click one to put it in the field you last clicked into.

An address field, such as a button’s, offers only tags that hold a web address, and the tag you pick replaces what’s in the field.

The Settings tab’s Header text and Footer text don’t take merge tags, because one wrapper goes around every email and the tags differ by email.

When a Tag Has No Value

A tag that belongs to the email and has no value for this reader prints nothing. If that would leave a stray line or button, make the block conditional with Show this block when…. Any other text in double braces, including a tag that belongs to a different email, stays exactly as you typed it.

In a preview, a tag with no sample value stays in braces, and the page says so.

Episode Notification Tags

The Episode notification email has tags of its own, filled in for each listener: the episode’s title, description, artwork, length and dates, {{player_image}} (the player card), {{episode_magic_link}} (the listener’s own link to the episode), {{episode_references}} (the episode’s references), {{episode_guests}} (the episode’s guests), and two for the teaser a listener who can’t hear the episode yet receives: {{episode_locked}} and {{episode_access_names}}. Make a block that only makes sense to someone who can listen conditional on {{episode_locked}} being empty.

Episode references ({{episode_references}}) holds the links you added to the episode, under a References heading, as its feed item shows them. It’s filled in for each listener as the email is sent, never stored in your design, so a reference you edit later still reaches the email. It’s empty for a listener who can’t hear the episode yet, and empty when the episode has none. The starting design places it after Listen now and Listen in your podcast app, in a block shown only when it has a value. A preview fills it with two sample links, A study of people who work nights and Our guest’s website. Episode guests ({{episode_guests}}) holds the names of the guests linked to the episode in the Guest Manager add-on, in the episode’s order, as Alice Smith and Bob Jones. Unlike references, it’s filled for a listener who can’t hear the episode yet too. It’s empty when Guest Manager isn’t installed or isn’t on for the episode’s show, and when the episode has no guests. A preview fills it with Alice Smith and Bob Jones.

The full list is on Email Merge Tags.

Tags From Other Add-ons

A tag declared through benecaster_email_merge_tag_catalog appears in the list automatically. Developers: give a web-address tag the kind url, or the address fields won’t offer it.

The full list for each email is on Email Merge Tags.

See Also

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

Last updated