HomeProduct DocsAPI ReferenceChangelog
RecurlyAPI GuidesRecurly.jsWebhooksAPI ReferenceSupportBook demo
Product Docs

Easy HTML guide: Common snippets

Access ready-to-use HTML snippets for Recurly email templates, including custom headers, compliant legal footers, and conditional boolean logic to dynamically personalize your subscription billing communications.

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

Common snippets

Copy, replace the highlighted values, and test.

Navigation Menu

Copy, replace, test

Paste each snippet where noted, replace the yellow values, and send a test.

1

Add your logo

Paste into your email header. Use a public URL for the image.

Email header: logoYellow = replace  ·  Blue = leave as-is
<div style="border-bottom:1px solid #E8E8E8; margin:0px 14px;">
  <img src="LOGO_IMAGE_URL" width="LOGO_WIDTH" alt="COMPANY_NAME" style="padding:0px 0px 6px 0px;" />
</div>
2

Add a custom footer

Paste into your email footer. If you have a second legal entity, add a line break and a second line with its name, registration, and address.

Email footer: legal blockYellow = replace  ·  Blue = leave as-is
<div id="legal">
  <em>
    <p>See the <a href="SUBSCRIPTION_TERMS_URL">Subscription Terms</a> for more information
    regarding your subscription. Review our <a href="PRIVACY_POLICY_URL">Privacy Policy</a>.</p>
    <p>This email was sent to: {{account_email}}. Please do not reply to this
    email as this address is not monitored.</p>
    <p>&copy; {{current_year}} COMPANY_NAME and its related entities. All Rights Reserved.</p>
    <p>ENTITY_NAME_1, ADDRESS_LINE_1</p>
  </em>
</div>
Check the year tag

{{current_year}} comes from the CSM template guide and is not in the Docs parameter list. If it shows blank in Preview, type the year instead.

3

Show a message only when it applies

Booleans are true-or-false statements. Recurly shows one block when the statement is true and another when it is false, so a renewal reminder can change if the subscription has a trial, a coupon, or a pending change. Use {{#tag?}} for true and {{^tag?}} for false, and close each block with its matching tag. See Boolean sections in Recurly Docs.

Example: trial or no trial
{{#subscription_has_trial?}}
  Your account will be billed {{{subscription_total_amount}}} in 10 days.
{{/subscription_has_trial?}}

{{^subscription_has_trial?}}
  Your mandate ID is: {{direct_debit_mandate_id}}.
{{/subscription_has_trial?}}
Example: renewal reminder with a pending change
{{#change_at_renewal?}}
  Your subscription is changing. At renewal you will be billed - {{{change_subscription_unit_amount}}}
{{/change_at_renewal?}}

{{^change_at_renewal?}}
  Your subscription is due to renew. You will renew to the same plan/price - {{{subscription_total_amount}}}
{{/change_at_renewal?}}
4

Add social links

Paste above the legal block in your footer. Delete any network you do not use.

Email footer: social links
<p>
  <a href="FACEBOOK_URL">Facebook</a> &nbsp;|&nbsp;
  <a href="LINKEDIN_URL">LinkedIn</a> &nbsp;|&nbsp;
  <a href="INSTAGRAM_URL">Instagram</a>
</p>

Did this page help you?