HomeProduct DocsAPI ReferenceChangelog
RecurlyAPI GuidesRecurly.jsWebhooksAPI ReferenceSupportBook demo
Product Docs

Easy HTML guide: Merge tags

Learn how to use Recurly merge tags to automatically insert dynamic subscriber data into your billing emails. This guide covers essential template parameters, currency formatting rules, and best practices for personalizing automated subscription communications securely.

Upcoming: Join our CSMs for a live session. Register now →
Launch Launch · Easy HTML guide

Merge tags

Insert subscriber data that Recurly fills in at send time.

Navigation Menu

What merge tags are

A merge tag is a placeholder in curly braces. When Recurly sends the email, it swaps the tag for that subscriber's data.

Email body
Hello {{account_first_name}}, your {{plan_name}} plan renews on
{{subscription_next_payment_date}} for {{{subscription_total_amount}}}.

Leave every tag exactly as written. You replace placeholder values, never merge tags.

Tags you will use most

TagWhat it inserts
{{account_first_name}}The account's first name
{{account_email}}The account's email address
{{plan_name}}The plan's display name
{{{subscription_total_amount}}}The subscription's total renewal amount
{{subscription_next_payment_date}}The date of the next charge
{{invoice_number}}The invoice number, with prefix
{{invoice_total}}The invoice total
{{company_name}}Your business entity's legal name

Wondering whether Recurly has a parameter for something else? Check the full parameter list in Recurly Docs.

Use three braces for currency

Tags such as {{{subscription_total_amount}}} need three braces so non-US currency symbols display correctly.

Keep sensitive data out

Never put card numbers or protected health information in a template.


Did this page help you?