Join us for an upcoming Shopify Partner webinar on February 27, 2024. Discover the latest Checkout Extensibility features, and deep dive on improvements to Shopify Functions and Web Pixels. Register now for either the 10am EST or 2pm EST sessions.

Differences between "email" and "contact_email" in orders API

9 0 1



Just found there are two attributes indicating the customers email related to a specific order, which are "contact_email" and "email". What the differences between them?

If I want to retrieve an order by both order name and the email address, which one should I use? Also consider the customer may checkout as a guest, which field is mandatory when customer making an order? 


Thanks in advance

Reply 1 (1)

Shopify Staff
1134 84 233

Hey there, 


In most cases you'll find the email and contact_email on an order being the same thing, even if someone is checking out as a guest they'll still need to provide either an e-mail address or phone number depending on the shop's settings. 


The main difference between the two is that in the event an email isn't provided on an order the email field won't be populated, but contact_email will consider other information like a customer account's email address so that the field doesn't necessarily end up being blank. 

Josh | Shopify 
 - Was my reply helpful? Click Like to let me know! 
 - Was your question answered? Mark it as an Accepted Solution
 - To learn more visit the Shopify Help Center or the Shopify Blog