Buttondown logo

Template tagsTemplate variables

Variables

email.publish_dateemail.secondary_idemail.is_premiumemail.subjectemail.absolute_urlmanage_subscription_urlmediumpremium_subscribe_urlrandom_numbersubscribe_formsubscribe_urlsubscriber.can_be_upsoldsubscriber.can_view_premium_contentsubscriber.emailsubscriber.idsubscriber.metadatasubscriber.subscriber_typesubscriber.tagsunsubscribe_urlupgrade_url

Fancy mode

IntroductionImagesText stylingDynamic blocks

Markdown mode

IntroductionSyntax guideButtondown's rendering engineConverting between fancy mode and markdown mode

Naked mode

Introduction

FAQ

What is `buttondown-editor-mode`?Can I use keyboard shortcuts in the editor?

Buttondown logo

Template variables

Template variables are a concept that have multiple names: "mail merges" might be one you're more familiar with if you have a marketing and email background.

The concept is to add snippets in your email that are programmatically replaced when Buttondown sends out an email. This with a little templating logic allows you to customize your content per-subscriber or to repeat certain key concepts in your email without having to change them over and over again.

Template variable library

Variable
email.publish_dateDate/time the email is sent.
email.secondary_idEmail issue number.
email.subjectEmail subject line.
email.absolute_urlPermalink to the email.
manage_subscription_urlLink to Portal.
medium'email' or 'web'.
premium_subscribe_urlUpgrade link for free subscribers.
random_numberRandom number for A/B testing.
subscribe_formEmbedded subscribe form.
subscribe_urlURL to your subscription page.
subscriber.can_be_upsoldIf subscriber can be upsold to paid.
subscriber.can_view_premium_contentIf subscriber can view premium content.
subscriber.emailSubscriber's email address.
subscriber.idSubscriber's unique ID.
subscriber.metadataSubscriber metadata.
subscriber.subscriber_typeSubscriber type (premium, regular, etc).
subscriber.tagsSubscriber's tag names.
unsubscribe_urlPersonalized unsubscribe link.
upgrade_urlUpgrade link for free subscribers.

Related