Multi-address Shipping – Shipping Confirmation Email Template

When configuring Giftship’s email templates, dynamic data can be outputted in the emails by referencing object variables using Liquid syntax. Depending on the final use case of the email template, different objects can be referenced.

For the multi-address shipping confirmation summary email, the following objects can be accessed:

• Shop
• Parent order — details of the original multi-address order
• Child orders — array of individual shipment orders

The Shop object is a Shopify liquid object, so please refer to their documentation on the available fields. In this article, we will cover the parent_order and child_orders objects in more detail.

Parent Order Object

The parent_order object include the following properties:

# name (string)
The display name of the order (e.g. #1001)

# email (string)
The email address associated with the customer for this order

Child Orders Array

Each item in child_orders represents a single shipment. Loop over them with {% for order in child_orders %}.

# name (string)
The child order display name (e.g. #1002)

# status_page_url (string)
URL to the order status page

# fulfillment_status (enum)
Fulfillment status of the shipment
— fulfilled
— partially_fulfilled
— unfulfilled

# shipping_address (object)
The recipient's shipping address (see Shopify object documentation)

# line_items (array)
Items in this shipment (see Shopify object documentation)

# shipping_lines (array)
Shipping method(s) for this shipment (see Shopify object documentation)

# note (string)
Contains the personal gift message information

# attributes (array)
Additional order attributes (see Shopify object documentation)

# tracking (array)
Tracking info entries (see below)

Each entry in the child order tracking array includes the following properties:

# number (string)
Tracking number

# url (string)
Carrier tracking URL

# company (number)
Carrier name (e.g. UPS)

Example Usage

The below shows examples of referencing parent_order and child_orders object variables in an email template:

<h2>Your order {{ parent_order.name }} is on its way!</h2>

{% for order in child_orders %}
  <h3>Shipment {{ order.name }}</h3>

  {% if order.is_fulfilled %}
    <p>Status: Fulfilled</p>
  {% elsif order.fulfillment_status == 'partially_fulfilled' %}
    <p>Status: Partially fulfilled</p>
  {% else %}
    <p>Status: Pending fulfillment</p>
  {% endif %}

  <p>
    Shipping to:
    {{ order.shipping_address.first_name }} {{ order.shipping_address.last_name }},
    {{ order.shipping_address.address1 }},
    {{ order.shipping_address.city }}, {{ order.shipping_address.province }}
  </p>

  {% for item in order.line_items %}
    <p>{{ item.title }} (Qty: {{ item.quantity }})</p>
  {% endfor %}

  {% if order.note %}
    <p>Note: {{ order.note }}</p>
  {% endif %}

  {% for attr in order.attributes %}
    <p><strong>{{ attr.key }}</strong>: {{ attr.value }}</p>
  {% endfor %}

  {% for tracking in order.tracking %}
    <p>
      {% if tracking.company %}{{ tracking.company }}: {% endif %}
      {% if tracking.url %}
        <a href="{{ tracking.url }}">{{ tracking.number }}</a>
      {% else %}
        {{ tracking.number }}
      {% endif %}
    </p>
  {% endfor %}

{% endfor %}

Example Data

The below is an example of a parent_order object with associated child_orders:

{
  "parent_order": {
    "id": "gid://shopify/Order/5678901234567",
    "name": "#1001",
    "email": "jane.smith@example.com"
  },
  "child_orders": [
    {
      "id": 42,
      "name": "#1002",
      "status_page_url": "https://mystore.myshopify.com/64836485334/orders/def456token/authenticate?key=xyz",
      "fulfillment_status": "fulfilled",
      "note": "Please leave at the front door.",
      "shipping_address": {
        "first_name": "Jane",
        "last_name": "Smith",
        "company": "",
        "address1": "123 Main St",
        "address2": "Apt 4B",
        "city": "New York",
        "province": "New York",
        "province_code": "NY",
        "zip": "10001",
        "country": "United States"
      },
      "line_items": [
        {
          "title": "Premium Gift Box",
          "variant_title": "Large / Red",
          "quantity": 1,
          "image": "https://cdn.shopify.com/s/files/1/0001/product-image.jpg"
        }
      ],
      "shipping_lines": [
        {
          "title": "Standard Shipping",
          "price": "5.00"
        }
      ],
      "attributes": [
        { "key": "Gift Message", "value": "Happy Birthday! Hope you enjoy this." },
        { "key": "Delivery Date", "value": "2026-05-29" }
      ],
      "tracking": [
        {
          "number": "1Z999AA10123456784",
          "url": "https://www.ups.com/track?tracknum=1Z999AA10123456784",
          "company": "UPS"
        }
      ]
    }
  ]
}