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.

Difference between the orders/updated and orders/edited webhooks

Shopify Partner
16 0 16

Naively these two webhooks sound rather similar. From the somewhat sparse documentation at, I can see that the message bodies have a different format but I was wondering when exactly these events fire. From some tests I've run it seems that many changes to an order fire orders/updated but not orders/edited. When does orders/edited fire? Is it just for changes to order line items?

Replies 2 (2)

Shopify Staff (Retired)
70 15 27

Hello, @Josh_Davis1!

I just checked with the orders team and the main difference is that 'orders/edited' is sent when the content of an order changes the value of goods sold (such as when a cross-sell offer is accepted at checkout), and 'orders/updated' changes whenever the order is updated at all (including when an 'orders/edited' webhook is triggered).

I agree that the documentation could be better. I have added this as an item for us to look into.

To learn more visit the Shopify Help Center or the Community Blog.

Shopify Partner
16 0 16

Hi James,

Thank you for the response; that clears it up for me. And thank you for adding the documentation to the to-do list.