Email templates

Control the default subject and message for customer-facing emails, use Liquid variables to add dynamic content and personalization

Kyle Weiskopf avatar
Written by Kyle Weiskopf
Updated over a week ago

Customer-facing emails

Customer Fields has built-in logic that triggers emails to be sent directly to customers when certain events occur. There's a total of seven (7) different customer-facing emails that are related to the app:

  • Customer account request - Sent to pending customers who request an account by submitting an account approval form.

  • Customer account deny - Sent to customers when their account request has been denied.

  • Customer account approval - Sent to customers when their account request has been approved.

  • Customer account invite - Sent to customers when they have been invited to create an account.

  • Customer account verification - Sent to existing customers when their email must be verified.

  • Customer account welcome - Sent to new customers when their account is activated.

  • Customer account password reset - Sent to existing customers when they use the "reset password" tool on an edit account form.

Some of the emails above are app-specific and sent by the app's email service, while others are managed and sent by Shopify.

Read more below for details regarding which emails are specific to the app, how to view & edit the templates for each email, the "from" address used when sending emails, domain sender authentication, and more.


Customizable email templates

App-specific emails

'Customer account request' and 'Customer account deny'

The emails for 'Customer account request' and 'Customer account deny' are truly unique to the Customer Fields app since these emails are used when approving or denying pending customers, which is a part of the app's account approval feature. These two emails are sent directly to customers using the app's email service.

You can fully customize the email templates for both of these emails using the app admin. Go to Settings > Email notifications > Email templates and then click on the name of the template you wish to edit:

πŸ“Œ Note: These two app-specific emails cannot be disabled or turned off when using an account approval form. Learn more about account approval here: Account options for forms - Require account approval

'Customer account verification'

The email for 'Customer account verification' is also unique to Customer Fields, but it's very similar to Shopify's 'Customer account invite' email. This particular email is sent by the app's email service, and the reason it exists is to ensure that the data collected by a form is not lost when the app runs into the "email verify" error (see more details here). This email is sent directly to customers using the app's email service.

If needed, you can customize the template for this email using the app admin by going to Settings > Email notifications > Email templates > Customer account verification. Please note that this specific template does not support the customer object; the only variables available for this email are the shop resource and verification_url.

Shopify emails

'Customer account approval' and 'Customer account invite'

The emails for 'Customer account approval' and 'Customer account invite' are essentially app-triggered versions of Shopify's 'Customer account invite' email. These emails are not sent by the app's email service -- the app simply tells Shopify to send the customer an invite email with a customized subject and message.

You're welcome to edit the default subject and message for these emails in the app admin, but the actual template for these emails is controlled in Shopify (found in the Shopify admin under Settings > Notifications > Customers notifications > Customer > Customer account invite).

'Customer account welcome'

The 'Customer account welcome' email comes directly from Shopify, and it's sent to a customer when their account is activated. This email is not sent by the app's email service nor is it intentionally triggered by the app -- Shopify's system just happens to be designed to send this email automatically whenever a new customer account is created/activated.

This email template cannot be edited within Customer Fields since it's controlled entirely by Shopify. If needed, you can customize the template for this email using the Shopify admin by going to Settings > Notifications > Customer > Customer account welcome.

'Customer account password reset'

The 'Customer account password reset' email comes from Shopify and is sent to a customer when they reset their password. In the context of Customer Fields, password resets will normally only occur on forms that have the 'Display password reset link' enabled in the form settings. This email is not sent by the app's email service -- the app simply tells Shopify to send the customer the store's native password reset email.

This email template cannot be edited within Customer Fields since it's controlled entirely by Shopify. If needed, you can customize the template for this email using the Shopify admin by going to Settings > Notifications > Customer > Customer account password reset.

Liquid code friendly

The app's template editor for emails is completely Liquid friendly! This means you can use things like control flow tags, iteration tags, and filters to add logic and render content in your ideal format & layout.

Pro-tip: We suggest using this documentation on Github if you need a good reference for Liquid.

Variables

You can also use Liquid variables for dynamic content within certain email templates. Variable support is template-specific, so the template editor in the app admin will display a list of the variables that are available based on the template you're editing. The two most common variables are detailed below:

shop Resource

The shop resource from Shopify can be used to output certain details about the store in email templates. Simply type in {{ shop. in the app's template editor to see a list of the properties available for this variable. You can also use the following documentation from Shopify to find more details on the different properties (aka attributes) for the shop resource:

customer Object

The customer object can be used to output certain details about the customer receiving the email. Simply type in {{ customer. in the app's template editor to see a list of the properties available for this variable. The customer object supports all of the data columns in the app; including Shopify data columns and custom data columns.

Code examples

If you want to display the value for a custom data column for maturity_date in the email body, along with the values for the customer's State/Province and Country, then you could use something like the following:

<p>Maturity Date: {{ customer.maturity_date | date: "%b %d, %Y" }}</p>
<p>Location: {{ customer.default_address.province }}, {{ customer.default_address.country }}</p>

Or perhaps you want to display the customer's first name in the email subject, along with the store's name. You can do so using something like this:

Hi {{ customer.first_name }}, your account for {{ shop.name }} has been approved!

"From" address for emails

By default, the emails triggered by Customer Fields are designed to use the 'Store contact email' or 'Sender email' as the "from" address. Both of these email addresses can be managed in the Shopify admin under Settings > Store details > Profile.

Note: When manually approving/denying customers or sending account invites, the app will allow you to choose which specific email address is used as the "from" address. In addition to the 'Store contact email' and 'Sender email', the app will also display a list of email addresses for each admin user who has accessed the app admin.

DNS records for Customer Fields

If you're using your own domain name for the 'Store contact email' and 'Sender email' in Shopify (found in the Shopify admin under Settings > Store details > Profile), then you may want to update your domain's DNS records to ensure that the emails sent by Customer Fields are delivered to your customer's inbox.

This is due to the fact that the app's emails are designed to use either of the Shopify email addresses as the "from" address. Since the app-specific emails are being sent by our app's email system (SendGrid), some email providers might flag the emails as spam unless you establish sender authentication for your domain using SPF and/or DKIM.

SPF

Adding an SPF record to your domain which references the hostname for Customer Fields' email system will help email providers determine that the emails being sent are valid and that they're not spam or phishing attempts.

Follow these steps to add an SPF record for Customer Fields to your domain's DNS:

  1. Log in to your domain hosting account.

  2. Find your domain's TXT record. This usually appears beside the CNAME record and MX record.

  3. Add the following SPF record to your existing TXT record: v=spf1 include:em6913.customerfields.com ~all

  4. Save your changes.

DKIM

Adding a DKIM record to your domain further enhances deliverability, and it's part of the requirements for implementing a DMARC policy (see details here). If your administrator has established a DMARC policy on your domain, then you'll need to contact our Customer Success team so we can get your domain added as an authenticated sender in our app's email service provider (SendGrid).

❗ Important: We require the use of the app's 'Advanced' plan (or above) if your domain needs DKIM/DMARC. Please contact us at support@heliumdev.com for assistance with sender authentication.


Need assistance with email templates?

Reach out to our Customer Success team via chat or email and we'll be happy to help!

Did this answer your question?