Transactional Emails

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.‌

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).







{{ship_address.firstname}}

{{#first_package_tracking.url}}

{{#line_items}}

{{name}

{{#options_text}}

{{#is_bundle}}

{{/parts}}

{{quantity}}

{{price}}

{{#promo_total}}

{{#payment_charge}}

{{shipment_total}}

{{#store_credit_applied}}

{{ship_address.full_name}}

{{ship_address.address1}}

{{#ship_address.address2}}

{{ship_address.city}},

{{ship_address.state}}

{{ship_address.zipcode}}

{{shipping_method}}

{{#trackings}}

{{#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:







Example 2:



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

‌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-