Chord OMS
Content Management (CMS)

Transactional Emails Templates/Variables

4min



Introduction

Transactional Emails are the mandatory post-purchase email communications you can send to customers. These emails are content managed in Contentful or Sanity and set via our email services.‌

Default Email Templates

Subscriptions (email name: slug) Subscription Reminder Email: subscription_default_reminder Subscription Last Chance Reminder Email: subscription_last_chance_reminder





Stock Requests (email name: slug) Item Back In Stock Email: back_in_stock





Reimbursements (email name: slug) Order Reimbursement Email: reimbursement_email





Refunds (email name: slug) (The same email template is used for refunds/reimbursements, they are two different things that coincide with a refund of money and/or an exchange) Order Refund Email: reimbursement_email





Referrals (email name: slug) Reward Confirmation Email‌: reward_confirmation Referral Prompt Email: referral_prompt





Orders (email name: slug) Order Confirmation Email: confirm_email Order Cancelation Email: cancel_email Order Cross Sell Email: cross_sell_email Checkout Abandoned Email‌: abandoned_email





Cartons (email name: slug) Order Shipped Email: shipped_email





Gift Cards (email name: slug) Gift Card Email: gift_card_email









Document image




Inky

In order to be more flexible in creating emails, we are using Inky as a templating language to essentially convert complex HTML tags into a much simpler approach.‌Inky simplifies the process of creating HTML emails by expanding out simple tags like and into full table syntax.



With Inky, we can inject variables into our HTML templates that will be replaced with values from the order when they are compiled into HTML (see {{ship_address.firstname}} in the example below).



Document image




Note: You can still use HTML‌‌!



Variables

{{ship_address.firstname}}

{{#first_package_tracking.url}}

{{#line_items}}

{{name}

{{/parts}}

{{quantity}}

{{price}}

{{#payment_charge}}

{{shipment_total}}

{{ship_address.full_name}}

{{ship_address.address1}}

{{#ship_address.address2}}

{{ship_address.city}},

{{ship_address.state}}

{{ship_address.zipcode}}

{{shipping_method}}

{{#url}}

{{order_total_after_store_credit}}

{{purl_link}

{{email}}

{{credit}}

{{reimbursement_total}}

{{updated_order_total}}

{{credit_balance}}

{{order.subscription_order,}}

{{order.spree_channel.name}}

{{ order.state}}

{{order.display_item_total.to_s}}

{{order.display_tax_total.to_s}}

{{order.display_total_applicable_store_credit.to_s}}

{{payment_information}}

{{order.cart_url.to_s}}

{{order.subscription_in_cart?}}

{{fully_cross_sold_line_items}}

{{partially_cross_sold_line_items}}

{{non_cross_sold_line_items}}

{{order.metadata}}

{{order.shipments.first&.shipping_method&.code}}

{{shipping_method_name}}

{{order.display_order_total_after_store_credit.to_s}}



Example 1:



Document image






Example 2:



Document image




Sections

Sections render blocks of text one or more times, depending on the value of the key in the current context.A section begins with a pound and ends with a slash. That is {{#person}}begins a "person" section while {{/person}} ends it. More information here



Additional Information

‌The main way to get started is with Foundation for Emails and CSS styled emails without the hassle

A tool to help implement and test customizations to Chord email templates.

If you can achieve your needs by overriding a few styles within the Contentful Email's Custom Styles field, this tool isn't necessary. It exists for those looking to completely customize the branding of their email templates.

Chord email templates are powered by Foundation for Emails and this repository is based on their foundation/foundation-emails-



If you have questions or need more information, please reach out to [email protected]