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 customer %}
  Customer is logged in. You can access the customer
  attributes such as {{ customer.first_name }}.
{% endif %}
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](/tutorials/develop-theme-templates-customers-account), [/customers/order.liquid](/tutorials/develop-theme-templates-customers-order) and [/customers/addresses.liquid](/tutorials/develop-theme-templates-customers-addresses) 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](/themes/customization/order-status/), 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](/docs/liquid/reference/objects/customer-address/) for a full list of available attributes.


{% for address in customer.addresses %}
  {{ address.street }}
{% endfor %}


126 York St, Suite 200 (Shopify Office)
123 Fake St
53 Featherston Lane


Returns the number of addresses associated with a customer.


Returns the default customer_address.

Returns the email address of the customer.


Returns the first name of the customer.


Returns true if the email associated with an order is also tied to a customer account. Returns false if it is not. Helpful in email templates.

Returns the id of the customer.


Returns the last name of the customer.


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


Your last order was placed on: {{ customer.last_order.created_at | date: "%B %d, %Y %I:%M%p" }}


Your last order was placed on: April 25, 2014 01:49PM

Returns the full name of the customer.


Returns an array of all orders placed by the customer.


{% for order in customer.orders %}
{{ }}
{% endfor %}




Returns the total number of orders a customer has placed.

Returns the phone number of the customer.


Returns the list of tags associated with the customer.


{% for tag in customer.tags %}
{{ tag }}
{% endfor %}


wholesale regular-customer VIP


Returns whether or not the customer is exempt from taxes.


Returns the total amount spent on all orders.