---
title: Trigger Shopify Flow when an order metafield changes
description: >-
  Start a Shopify Flow workflow when an order metafield changes. Track it in
  Workflow Trigger Extensions and get the old and the new value.
source_url:
  html: >-
    https://docs.workflow-trigger-extensions.app/order-metafield-trigger
  md: >-
    https://docs.workflow-trigger-extensions.app/order-metafield-trigger.md
---

# Order metafield trigger

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](https://docs.workflow-trigger-extensions.app/permissions-and-data-access.md).

## 1. Track the metafield

1. Open **Metafield Triggers** in the app and click **Add trigger**.
2. Choose the resource type **Order**.
3. Tick the metafield, here **Gift message**. You can tick several at once or use **Select all**.
4. 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 Add Metafield Trigger dialog with resource type Order and the metafield Gift message, custom.gift_message, ticked](https://cdn-dev.eu.codecreationlabs.cloud/crm-tool/uploads/SjJ78gKLnLlocopCui3Cs62dJbGZ7F1n/a8e0b196790333b0.png)
*Resource type Order, the metafield ticked. All metafields tracks every metafield of the type instead.*

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

1. In Shopify Flow, create a workflow and choose the trigger **Metafield Update** of **Workflow Trigger Extensions**.
2. Add a **Condition**: `resourceType` is equal to `ORDER`. 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, add `metafieldKey` is equal to `custom.gift_message` as a second criterion.
3. Add the action you need. The example sends an internal email with the old and the new value.

![The example workflow in Shopify Flow: Metafield Update, a condition on resource type ORDER and Send internal email](https://cdn-dev.eu.codecreationlabs.cloud/crm-tool/uploads/SjJ78gKLnLlocopCui3Cs62dJbGZ7F1n/38eca719d87b2619.png)
*The example workflow: the trigger, the condition on the resource type and one action.*

### Start from the example

1. Download the `.flow` file attached at the bottom of this page.
2. In your Shopify admin open **Flow**, click **Import** and choose the file.
3. Open the **Send internal email** step and enter the recipient. The file holds no address on purpose.
4. 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.value` is 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.

> [!NOTE]
> **Counts toward your plan**
> Every change of a tracked metafield counts as one event of your plan, see [Plans and usage](https://docs.workflow-trigger-extensions.app/plans-and-usage.md).

## More

- [Metafield triggers](https://docs.workflow-trigger-extensions.app/metafield-triggers.md): how metafield triggers work, for every resource type.
- [Trigger Shopify Flow on order metafield updates](https://docs.workflow-trigger-extensions.app/order-metafield-update-guide.md): a worked example with a video.
- [Event history and troubleshooting](https://docs.workflow-trigger-extensions.app/event-history-and-troubleshooting.md): see every event the app sent, with the old and the new value.
