The customer object

The customer object contains information about a customer who has a customer account.

Where and when is it defined

The customer object is global in the sense that you can access it in all layout, template and snippet files. However, the object is only defined when a customer is logged-in. You can verify if a customer is logged-in with this code:

If one is able to view a store page that lives under /accounts then one is logged-in, therefore you don't need to check if customer is defined in the templates /customers/account.liquid, /customers/order.liquid and /customers/addresses.liquid before you access the variable's attributes.

The customer variable can also be accessed in email templates, on the order status page of the checkout, as well as in apps such as Order Printer.

Attributes

customer.accepts_marketing

Returns true if the customer accepts marketing, returns false if the customer does not.

customer.addresses

Returns an array of all addresses associated with a customer. See customer_address for a full list of available attributes.

customer.addresses_count

Returns the number of addresses associated with a customer.

customer.default_address

Returns the default customer_address.

customer.email

Returns the email address of the customer.

customer.first_name

Returns the first name of the customer.

customer.has_account

Returns true if the email associated with the customer is tied to a customer account. Returns false if it is not.

A customer can complete a checkout without making an account with the store. If the customer doesn't have an account with the store, then customer.has_account is false when accessed in email templates and at checkout.

During the checkout process, if the customer has an account with the store and enters an email associated with their account, then customer.has_account is true. The email is associated to the account regardless of whether the customer has logged into their account.

customer.id

Returns the id of the customer.

customer.last_name

Returns the last name of the customer.

customer.last_order

Returns the last order placed by the customer, not including test orders.

customer.name

Returns the full name of the customer.

customer.orders

Returns an array of all orders placed by the customer.

customer.orders_count

Returns the total number of orders a customer has placed.

customer.phone

Returns the phone number of the customer.

customer.tags

Returns the list of tags associated with the customer.

customer.tax_exempt

Returns whether or not the customer is exempt from taxes.

customer.total_spent

Returns the total amount spent on all orders.