Help Center
English
Contents

Welcome Email

Welcomes a customer who created an account.

When it's sent

Sent once, the first time a customer signs in with an email address on file, while Send welcome email is on in Customer settings: after registering, or when someone who checked out as a guest or whom you added signs in for the first time. Not sent at creation, and not to customers you added, imported or created through the Store API with the welcome email turned off.

At a glance
  • Category: Transactional. About something the customer did or asked for, such as an order, a refund, a gift card or a request.

  • Channels: Email

  • Can be switched off: Yes

What it also needs

It goes only on channels that are switched on. Email needs the customer's email address. On by default.

Related settings
  • Transactional emails

Values it can read

Its template can print these values. Write a value's path between double braces, such as {{ shop.name }}. [] marks one entry of a list, read inside a loop: order.items[].title is item.title in {% for item in order.items %}. A value the event has no data for prints nothing.

It is sent only by email.

Customer#

Value

Path

First name

customer.first_name

Last name

customer.last_name

Email address

customer.email

Has an account

customer.has_account

Store#

Value

Path

Store name

shop.name

Store link

shop.url

Store logo

shop.logo_url

Support email

shop.support_email

Store address

shop.address

Store address › First name

shop.address.first_name

Store address › Last name

shop.address.last_name

Store address › Company name

shop.address.company

Store address › Address line 1

shop.address.address1

Store address › Address line 2

shop.address.address2

Store address › District

shop.address.district

Store address › City

shop.address.city

Store address › State or region code

shop.address.province_code

Store address › State or region

shop.address.province_name

Store address › Postal code

shop.address.postal_code

Store address › Country code

shop.address.country_code

Store address › Country

shop.address.country_name

Store address › Phone number

shop.address.phone

Store address › Full address

shop.address.formatted

Social links

shop.social

Social links › Network

shop.social[].network

Social links › Profile link

shop.social[].url

This email#

Value

Path

Preview text

email.preview_text

Email parts it can use

Its email code can add these parts of the email library with {% render %}. An email offers only the parts it has data for.

  • {% render 'button' %}: A button in your accent colour that works in every email program.

  • {% render 'eyebrow' %}: A small line in capitals above a heading, such as the order number and date.

  • {% render 'footer' %}: The store's name and its support address.

  • {% render 'header' %}: The store's logo (from Email design), or its name when there is no logo, linking to the store.

Was this page helpful?