> For the complete documentation index, see [llms.txt](https://eraya.gitbook.io/eraya-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://eraya.gitbook.io/eraya-docs/eraya-analytics-specification/tagging-orders-in-shopify.md).

# Tagging Orders in Shopify

### Overview

To ensure Eraya can correctly attribute orders to their respective test variations (Control or Variant), you’ll need to set up an automated workflow in **Shopify Flow**.\
This workflow uses **custom attributes** that Eraya adds during checkout to tag orders in Shopify with the correct **test ID** and **variation (A/B)**.

***

### ⚙️ Prerequisites

Before you begin:

1. Make sure you have installed the [**Shopify Flow app**](https://apps.shopify.com/flow).
2. Identify the **test type** and copy its **test ID** from your Eraya dashboard.

| Test Type         | Test ID Attribute         | Variation Attribute         |
| ----------------- | ------------------------- | --------------------------- |
| **Price Test**    | `_eraya_test_id`          | `_eraya_variation`          |
| **Theme Test**    | `_eraya_theme_test_id`    | `_eraya_theme_variation`    |
| **Shipping Test** | `_eraya_shipping_test_id` | `_eraya_shipping_variation` |

***

### Steps to Create the Workflow

#### 1. Create a New Workflow

* Open the **Shopify Flow app** in your Shopify admin.
* Click **Create workflow** (top-right).
* Click **Select a trigger**.
* For the trigger, choose **Order created**.

***

#### 2. Add a Condition

* Click the **blue “+”** icon on the **Order created** card and select **Condition**.
* Click **Add criteria** → **Order** → **lineItems** → **customAttributes** → **value**.
* Change the **“Equals”** dropdown to **“Includes”**.
* Paste your **test ID** (copied from the Eraya dashboard) into the **Value** field.

<figure><img src="/files/ZjpiCFWxvw7cq8FjHLSG" alt=""><figcaption></figcaption></figure>

\
Example:

```
68c84559308bf515cf681476
```

***

#### 3. Add an Action (Variation B)

* Click the **blue “+”** next to **Then** in the “Check if…” card and select **Action**.
* Choose **Add order tags**.
* Add the following tags:

  ```
  B, 68c84559308bf515cf681476
  ```

  *(Replace the ID with your actual test ID.)*

***

#### 4. Add a Second Condition (Variation A)

* Below the **False** branch, click **Add condition** again.
* Use the same structure:
  * **Order → lineItems → customAttributes → value**
  * Change **Equals** to **Includes**
  * Enter the same test ID.
* Then add another criterion:
  * **Order → lineItems → customAttributes → value**
  * Change **Equals** to **Includes**
  * Enter `a` for the control group.

***

#### 5. Add an Action (Variation A)

* Under the **True** branch, select **Add order tags**.
* Add tags for the control group:

  ```
  A, 68c84559308bf515cf681476
  ```

***

#### 6. Activate the Workflow

Once your flow looks similar to the diagram below (with both **A** and **B** branches configured):

```
Order created
   ↓
Condition (_eraya_test_id includes TestID, _eraya_variation includes b)
   ├── True → Add order tags: "B, <TestID>"
   └── False → Condition (_eraya_test_id includes TestID, _eraya_variation includes a)
                 ├── True → Add order tags: "A, <TestID>"
```

Click **Turn on workflow** (top-right corner) to activate it.

***

### Example Attribute Values

Here’s how Eraya sends attributes to Shopify:

```js
// Price Test
{
  _eraya_test_id: "68c84559308bf515cf681476",
  _eraya_variation: "a" // or "b"
}

// Theme Test
{
  _eraya_theme_test_id: "78d21459abc874f951c",
  _eraya_theme_variation: "b"
}

// Shipping Test
{
  _eraya_shipping_test_id: "98f84559308bf515cf681aa",
  _eraya_shipping_variation: "a"
}
```

***

### Notes

* You can duplicate this same workflow for each **test type** (Price, Theme, Shipping) by simply updating the attribute keys.
* Always tag both the **variation (A/B)** and the **test ID** — this allows Eraya’s analytics to group and attribute orders correctly.
* Once enabled, every order will automatically include tags like:

  ```
  A, 68c84559308bf515cf681476
  ```

  or

  ```
  B, 68c84559308bf515cf681476
  ```