Appearance
Are you an LLM? You can read better optimized documentation at /docs/automation/magic-tags.md for this page in Markdown format
Magic Tags
Magic tags are placeholders that fill in real details when your content is used. Write an email once with {guest_first_name} in it, and every guest gets a message addressed to them personally.
A tag is a name in single curly braces, lowercase with underscores: {guest_first_name}, {episode_title}, {recording_date}. When an automation runs or a template is applied, each tag is replaced with the real value from that run.
Where magic tags work
- Email templates: in the subject line and the body
- Webhook payloads: anywhere in the JSON body of a webhook step
- Show notes templates: in the section title and content, filled in when an episode's notes are created
- Update-field values: in the new value of an update-field step
- Email addressing:
{guest_email}and{guests_emails}resolve to addresses, so they work in a send-email step's Send to and CC emails fields
How to insert a tag
You never have to memorize tag names:
- Insert Tag browser: in the template editor, the webhook payload editor, and the update-field editor, click Insert Tag to browse every tag by category, with a description of each. Clicking one drops it at your cursor.
- Email tags chips: the send-email step in the flow builder shows clickable chips for the email-address tags. Click to copy, then paste into Send to or CC emails.
- Type it by hand: any valid tag name in single braces works anywhere tags are supported.
Preview before you send
In the template editor, click Preview to see your subject and body with sample values filled in.
Tag categories
Tags are grouped into six categories. A few examples from each:
| Category | Examples |
|---|---|
| Guest | {guest_first_name}, {guest_email}, {guests_full_names} (every attendee on the booking) |
| Episode | {episode_title}, {episode_number}, {episode_description} |
| Podcast | {podcast_name}, {podcast_host_name}, {podcast_website} |
| Booking | {booking_link_name}, {guest_notes} |
| Dates & Times | {recording_date}, {recording_time}, {days_until_recording}, {publish_date} |
| Links | {meeting_url}, {guest_portal_link}, {episode_url}, {podcast_listen_link} |
The full catalog, with what every tag resolves to, lives in the Magic Tags List.
When a tag has no value
Tags resolve from the context of the run that uses them:
- Podcast tags always have values.
- Guest, booking, and episode tags need that record connected to the run. A booking-triggered automation has all three; an episode-triggered one has no booking, so
{meeting_url}would come up empty there. - Directory link tags like
{podcast_apple_url}and{podcast_spotify_url}stay empty until your show is confirmed live on that directory.{podcast_listen_link}always resolves.
In show notes created from a template, an unresolved tag stays visible as the literal tag text, so you can spot it and fill it in while editing.
What's Next?
- Browse the complete Magic Tags List
- Use tags in your templates
- Build an automation that puts them to work