FROM CACHE - en_header

Difference between the orders/updated and orders/edited webhooks

Josh_Davis1
Shopify Partner
11 0 9

Naively these two webhooks sound rather similar. From the somewhat sparse documentation at https://shopify.dev/docs/admin-api/rest/reference/events/webhook, 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)
james-langille
Shopify Staff (Retired)
Shopify Staff (Retired)
70 15 24

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.

james-langille | Developer @ 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 Shopify.dev or the Shopify Web Design and Development Blog

Josh_Davis1
Shopify Partner
11 0 9

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.

-Josh