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 sent via Chord's email services.‌

(email name: slug)

Subscriptions

Stock Requests

Reimbursements

Refunds (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)

Referrals

Orders

Cartons/Shipments

Gift Cards

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



Example one:

Example two:



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-



You may decide to disable our transactional templates. Instead, you can use Email Queued events to trigger your own transactional emails with an external service like Klaviyo or Iterable.

Disabling all transactional emails is accomplished by setting TRANSACTIONAL_EMAILS_ENABLED to disabled . This setting is configurable on a per-store basis in the Environment Variables section in Settings / Store

You also have the option to deactivate specific email template. This functionality allows you to enable or disable transactional emails individually by incorporating an optional boolean field, "enabled," into the Email content type within Contentful. If this field is present and set to "no," the respective email template will be deactivated.