---
title: "Order Editing Tags"
description: "Every Shopify order tag that Order Editing applies, what triggers it, and how to use tags in your workflows."
url: https://docs.orderediting.com/en/articles/14162676-order-editing-tags
collection: "Order Activity"
updated: 2026-11-05
language: en
---

# Order Editing Tags

Every Shopify order tag that Order Editing applies, what triggers it, and how to use tags in your workflows.

# Overview

When a customer interacts with Order Editing, the app automatically tags the Shopify order to reflect what happened. These tags let you track order changes, build Shopify Flow automations, filter orders in your Shopify admin, and integrate with third-party tools that read order tags.

This article covers every tag Order Editing can apply, grouped by category. Each tag is shown in `code format` exactly as it appears on the Shopify order.

You can use these tags as triggers or conditions in Shopify Flow workflows. For example, trigger a Flow when an order is tagged with `orderediting:cancellation_requested` to route cancellation requests to your support team for manual review.

# Product-related tags

These tags are applied when a customer makes changes to the products in their order.

<table style="min-width: 50px;"><colgroup><col style="min-width: 25px;"><col style="min-width: 25px;"></colgroup><tbody><tr><th colspan="1" rowspan="1"><p><strong>Tag</strong></p></th><th colspan="1" rowspan="1"><p><strong>When it's applied</strong></p></th></tr><tr><td colspan="1" rowspan="1"><p><code>orderediting:product_added</code></p></td><td colspan="1" rowspan="1"><p>A product has been added to the order.</p></td></tr><tr><td colspan="1" rowspan="1"><p><code>orderediting:product_removed</code></p></td><td colspan="1" rowspan="1"><p>A product has been removed from the order.</p></td></tr><tr><td colspan="1" rowspan="1"><p><code>orderediting:quantity</code></p></td><td colspan="1" rowspan="1"><p>Product quantity has been modified.</p></td></tr><tr><td colspan="1" rowspan="1"><p><code>orderediting:variant</code></p></td><td colspan="1" rowspan="1"><p>Product variant has been changed (e.g. size, colour).</p></td></tr></tbody></table>

* * *

# Order status tags

These tags reflect the overall status of the order after a customer has interacted with Order Editing.

<table style="min-width: 50px;"><colgroup><col style="min-width: 25px;"><col style="min-width: 25px;"></colgroup><tbody><tr><th colspan="1" rowspan="1"><p><strong>Tag</strong></p></th><th colspan="1" rowspan="1"><p><strong>When it's applied</strong></p></th></tr><tr><td colspan="1" rowspan="1"><p><code>orderediting</code></p></td><td colspan="1" rowspan="1"><p>Actions taken by the customer have been saved to the order.</p></td></tr><tr><td colspan="1" rowspan="1"><p><code>orderediting:downsized</code></p></td><td colspan="1" rowspan="1"><p>Customer saved order edits that reduced their total order value.</p></td></tr><tr><td colspan="1" rowspan="1"><p><code>orderediting:duplicated</code></p></td><td colspan="1" rowspan="1"><p>Shopify Flow created this order by duplicating it from the original.</p></td></tr><tr><td colspan="1" rowspan="1"><p><code>orderediting:reversed</code></p></td><td colspan="1" rowspan="1"><p>Eligible order edits have been reversed by Order Editing, including a supported Flow-triggered reversal.</p></td></tr></tbody></table>

* * *

# Cancellation tags

These tags track the lifecycle of an order cancellation, from request through to completion, including the refund method used.

<table style="min-width: 50px;"><colgroup><col style="min-width: 25px;"><col style="min-width: 25px;"></colgroup><tbody><tr><th colspan="1" rowspan="1"><p><strong>Tag</strong></p></th><th colspan="1" rowspan="1"><p><strong>When it's applied</strong></p></th></tr><tr><td colspan="1" rowspan="1"><p><code>orderediting:cancellation_requested</code></p></td><td colspan="1" rowspan="1"><p>Order cancellation has been requested by the customer.</p></td></tr><tr><td colspan="1" rowspan="1"><p><code>orderediting:cancellation_approved</code></p></td><td colspan="1" rowspan="1"><p>Order cancellation has been approved.</p></td></tr><tr><td colspan="1" rowspan="1"><p><code>orderediting:cancelled</code></p></td><td colspan="1" rowspan="1"><p>Order has been cancelled.</p></td></tr><tr><td colspan="1" rowspan="1"><p><code>cancelled_store_credit</code></p></td><td colspan="1" rowspan="1"><p>Order cancelled with store credit issued as the refund method.</p></td></tr><tr><td colspan="1" rowspan="1"><p><code>cancelled_payment_gateway</code></p></td><td colspan="1" rowspan="1"><p>Order cancelled with refund issued through the original payment gateway.</p></td></tr><tr><td colspan="1" rowspan="1"><p><code>cancelled_support_ticket</code></p></td><td colspan="1" rowspan="1"><p>Order cancelled via support ticket (routed through Shopify Flow).</p></td></tr></tbody></table>

* * *

# Address and shipping tags

These tags are applied when a customer modifies their address or shipping details.

<table style="min-width: 50px;"><colgroup><col style="min-width: 25px;"><col style="min-width: 25px;"></colgroup><tbody><tr><th colspan="1" rowspan="1"><p><strong>Tag</strong></p></th><th colspan="1" rowspan="1"><p><strong>When it's applied</strong></p></th></tr><tr><td colspan="1" rowspan="1"><p><code>orderediting:billing</code></p></td><td colspan="1" rowspan="1"><p>Billing address has been updated.</p></td></tr><tr><td colspan="1" rowspan="1"><p><code>orderediting:shipping</code></p></td><td colspan="1" rowspan="1"><p>Shipping address has been updated.</p></td></tr><tr><td colspan="1" rowspan="1"><p><code>orderediting:shipping_method</code></p></td><td colspan="1" rowspan="1"><p>Shipping method has been modified.</p></td></tr><tr><td colspan="1" rowspan="1"><p><code>orderediting:shipping_upgrade</code></p></td><td colspan="1" rowspan="1"><p>Shipping has been upgraded to a faster or premium method.</p></td></tr></tbody></table>

* * *

# Payment and invoice tags

These tags track payment-related changes and invoice actions on the order.

<table style="min-width: 50px;"><colgroup><col style="min-width: 25px;"><col style="min-width: 25px;"></colgroup><tbody><tr><th colspan="1" rowspan="1"><p><strong>Tag</strong></p></th><th colspan="1" rowspan="1"><p><strong>When it's applied</strong></p></th></tr><tr><td colspan="1" rowspan="1"><p><code>orderediting:invoice</code></p></td><td colspan="1" rowspan="1"><p>Action resulted in sending an invoice to the customer.</p></td></tr><tr><td colspan="1" rowspan="1"><p><code>orderediting:invoice_printed</code></p></td><td colspan="1" rowspan="1"><p>Invoice has been printed for the customer.</p></td></tr><tr><td colspan="1" rowspan="1"><p><code>orderediting:change_payment</code></p></td><td colspan="1" rowspan="1"><p>Payment method has been changed.</p></td></tr><tr><td colspan="1" rowspan="1"><p><code>orderediting:code_redemption</code></p></td><td colspan="1" rowspan="1"><p>Discount code has been applied to the order.</p></td></tr><tr><td colspan="1" rowspan="1"><p><code>orderediting:discount</code></p></td><td colspan="1" rowspan="1"><p>A discount has been applied to the order.</p></td></tr></tbody></table>

* * *

# Communication tags

These tags are applied when communication-related actions occur on the order.

<table style="min-width: 50px;"><colgroup><col style="min-width: 25px;"><col style="min-width: 25px;"></colgroup><tbody><tr><th colspan="1" rowspan="1"><p><strong>Tag</strong></p></th><th colspan="1" rowspan="1"><p><strong>When it's applied</strong></p></th></tr><tr><td colspan="1" rowspan="1"><p><code>orderediting:email_updated</code></p></td><td colspan="1" rowspan="1"><p>Customer email address has been updated.</p></td></tr><tr><td colspan="1" rowspan="1"><p><code>orderediting:message</code></p></td><td colspan="1" rowspan="1"><p>Customer contacted the store through Order Editing.</p></td></tr><tr><td colspan="1" rowspan="1"><p><code>orderediting:email_sent</code></p></td><td colspan="1" rowspan="1"><p>Post-purchase email sent to the customer.</p></td></tr></tbody></table>

* * *

# Authorization tags

These tags relate to payment authorization status on orders within the editing window.

<table style="min-width: 50px;"><colgroup><col style="min-width: 25px;"><col style="min-width: 25px;"></colgroup><tbody><tr><th colspan="1" rowspan="1"><p><strong>Tag</strong></p></th><th colspan="1" rowspan="1"><p><strong>When it's applied</strong></p></th></tr><tr><td colspan="1" rowspan="1"><p><code>orderediting:authorization_warning</code></p></td><td colspan="1" rowspan="1"><p>Notification that the order's payment authorization is close to expiry.</p></td></tr><tr><td colspan="1" rowspan="1"><p><code>orderediting:authorization_captured</code></p></td><td colspan="1" rowspan="1"><p>Payment has been captured to avoid order expiration.</p></td></tr></tbody></table>

* * *

# ShipHero integration tags

These tags are specific to the ShipHero integration and track hold status on orders sent to ShipHero for fulfilment.

<table style="min-width: 50px;"><colgroup><col style="min-width: 25px;"><col style="min-width: 25px;"></colgroup><tbody><tr><th colspan="1" rowspan="1"><p><strong>Tag</strong></p></th><th colspan="1" rowspan="1"><p><strong>When it's applied</strong></p></th></tr><tr><td colspan="1" rowspan="1"><p><code>shiphero:hold</code></p></td><td colspan="1" rowspan="1"><p>Order put on hold in ShipHero during the editing window.</p></td></tr><tr><td colspan="1" rowspan="1"><p><code>shiphero:release</code></p></td><td colspan="1" rowspan="1"><p>Hold released in ShipHero after the editing window closes.</p></td></tr><tr><td colspan="1" rowspan="1"><p><code>shiphero:fail</code></p></td><td colspan="1" rowspan="1"><p>Failed to communicate with ShipHero.</p></td></tr></tbody></table>

* * *

# Support and special cases tags

These tags cover edge cases, errors, and special features.

<table style="min-width: 50px;"><colgroup><col style="min-width: 25px;"><col style="min-width: 25px;"></colgroup><tbody><tr><th colspan="1" rowspan="1"><p><strong>Tag</strong></p></th><th colspan="1" rowspan="1"><p><strong>When it's applied</strong></p></th></tr><tr><td colspan="1" rowspan="1"><p><code>requires_customer_support</code></p></td><td colspan="1" rowspan="1"><p>An error occurred that requires human intervention. Check the order for issues.</p></td></tr><tr><td colspan="1" rowspan="1"><p><code>orderediting:metafields</code></p></td><td colspan="1" rowspan="1"><p>A customer metafield has been updated.</p></td></tr><tr><td colspan="1" rowspan="1"><p><code>orderediting:rescheduled</code></p></td><td colspan="1" rowspan="1"><p>Delivery has been rescheduled.</p></td></tr><tr><td colspan="1" rowspan="1"><p><code>orderediting:upsell</code></p></td><td colspan="1" rowspan="1"><p>Order was upsold and is considered fully paid.</p></td></tr></tbody></table>

* * *

# Downgrade-related tags

These tags are applied when a customer's order edits result in a lower order value (a downgrade) and track how the refund difference was handled.

<table style="min-width: 50px;"><colgroup><col style="min-width: 25px;"><col style="min-width: 25px;"></colgroup><tbody><tr><th colspan="1" rowspan="1"><p><strong>Tag</strong></p></th><th colspan="1" rowspan="1"><p><strong>When it's applied</strong></p></th></tr><tr><td colspan="1" rowspan="1"><p><code>order_downgrade_store_credit</code></p></td><td colspan="1" rowspan="1"><p>Order downgraded with the difference issued as store credit.</p></td></tr><tr><td colspan="1" rowspan="1"><p><code>order_downgrade_payment_gateway</code></p></td><td colspan="1" rowspan="1"><p>Order downgraded with the difference refunded through the original payment gateway.</p></td></tr><tr><td colspan="1" rowspan="1"><p><code>order_downgrade_support_ticket</code></p></td><td colspan="1" rowspan="1"><p>Order downgraded with the refund routed via support ticket (through Shopify Flow).</p></td></tr></tbody></table>

* * *

# Remove a custom tag after a later edit

A custom tag applied by your team or another Shopify Flow needs its own removal rule. For example, a size-change tag does not necessarily disappear if the customer changes back to the original size.

Check which workflow added the tag and use the current order state to define removal. Do not use removal of a tag as proof that a native Shopify hold, payment or cancellation has completed.

# FAQ

# Can an order have multiple Order Editing tags?

Yes. An order can accumulate multiple tags as the customer makes different changes. For example, if a customer adds a product and updates their shipping address, the order will be tagged with both `orderediting:product_added` and `orderediting:shipping`.

# Can I use these tags in Shopify Flow?

Yes. All Order Editing tags can be used as triggers or conditions in Shopify Flow workflows. This is one of the most powerful uses of tags. You can build automations like: when an order is tagged with `orderediting:cancellation_requested`, send a Slack notification to your ops team, or when an order is tagged with `requires_customer_support`, create a support ticket automatically.

# Can I remove Order Editing tags from an order?

Yes. Order Editing tags behave like any other Shopify order tag. You can remove them manually from the order detail page in your Shopify admin, or remove them programmatically via Shopify Flow or the Shopify API. Removing a tag doesn't reverse the action it represents.

# Can I filter orders by these tags in my Shopify admin?

Yes. In your Shopify admin, go to **Orders** and use the tag filter to search for any Order Editing tag. This is useful for finding all orders where a specific action occurred, like all cancelled orders or all orders with address changes.

## Related

- [Order Insights on the Shopify Order Page](https://docs.orderediting.com/en/articles/15319634-order-insights-on-the-shopify-order-page.md)
- [Order Editing Actions in the Shopify Admin](https://docs.orderediting.com/en/articles/15319404-order-editing-actions-in-the-shopify-admin.md)
- [Understanding Order Editing Timeline Events](https://docs.orderediting.com/en/articles/14330153-understanding-order-editing-timeline-events.md)
