Order metafield trigger
Start a Shopify Flow workflow when an order metafield changes. Track it in Workflow Trigger Extensions and get the old and the new value.
A customer asks support to add a gift note after the order was placed. Support writes it into the order metafield Gift message (custom.gift_message), and the packing team must see it before the parcel leaves.
This page shows how to start a Shopify Flow workflow whenever a metafield of an order changes, with Workflow Trigger Extensions. The steps are the same for every metafield of this resource type; the example uses Gift message (custom.gift_message).
What you need
- A metafield definition. Create it in your Shopify admin under Settings > Metafields and metaobjects > Orders. A metafield without a definition cannot be tracked.
- The permission Order Data Access. Grant it on the app's Permissions page, see Permissions and data access.
1. Track the metafield
- Open Metafield Triggers in the app and click Add trigger.
- Choose the resource type Order.
- Tick the metafield, here Gift message. You can tick several at once or use Select all.
- Click Add trigger.
To track every metafield of this resource type, including the ones you create later, choose All metafields instead of ticking single ones, then click Track all metafields.

The new trigger shows Initializing while the app reads the current value of the metafield on your existing orders, then Active. That first reading is why the very first change already arrives with the right previous value.
If the metafield is missing from the list, click Refresh Metafields on the Metafield Triggers page: the app remembers the list of definitions for an hour.
2. What the workflow receives
Every change starts the trigger Metafield Update in Shopify Flow with these values:
| Variable | Value |
|---|---|
resourceType |
ORDER |
resourceId |
The ID of the order, for example gid://shopify/Order/1234567890 |
metafieldKey |
Namespace and key, here custom.gift_message |
metafield.value |
The new value |
metafield.previousValue |
The value before the change, empty when the metafield was set for the first time |
metafield.type |
The type of the metafield, for example single_line_text_field |
Order Metafield Update is a second trigger for the same change. It starts in addition to Metafield Update and carries the order as a native Flow reference, so Shopify's own order actions work on it without a lookup step. Both share one event, so using both does not count twice. Switch it on from the app's Triggers page, or turn on a workflow that uses it.
3. Build the workflow
- In Shopify Flow, create a workflow and choose the trigger Metafield Update of Workflow Trigger Extensions.
- Add a Condition:
resourceTypeis equal toORDER. Metafield Update starts for every resource type you track, so the condition keeps this workflow to orders. When you track several metafields of the type, addmetafieldKeyis equal tocustom.gift_messageas a second criterion. - Add the action you need. The example sends an internal email with the old and the new value.

Start from the example
- Download the
.flowfile attached at the bottom of this page. - In your Shopify admin open Flow, click Import and choose the file.
- Open the Send internal email step and enter the recipient. The file holds no address on purpose.
- Turn the workflow on.
Make it yours
- Tag the order: add the action Add order tags and put
{{resourceId}}in its order field. - Add the condition "
metafield.valueis not empty" so a removed message sends nothing. - Use Order Metafield Update when the workflow should read line items or the shipping address.
How fast it reacts
Shopify notifies the app when an order is saved, so the workflow usually starts within a few seconds.
Good to know
- By default the app watches orders created in the last 60 days. Older orders need full order history access on the Permissions page and a longer range in the app's order history setting.
More
- Metafield triggers: how metafield triggers work, for every resource type.
- Trigger Shopify Flow on order metafield updates: a worked example with a video.
- Event history and troubleshooting: see every event the app sent, with the old and the new value.
