Skip to main content

Custom Properties (Personalization)

Pass custom line item properties (like embroidery text or gift messages) from the parent bundle to each individual item on the order.

Updated yesterday

How It Works

When customers enter customizations on a Collection Bundle, those properties are transferred to each individual product at checkout — so fulfillment staff see the instructions on every line item.

Example: Customer enters "John Smith" for embroidery → each bundle item shows "Embroidery: John Smith" in the order.


Adding a Custom Property Input

Add a Custom Liquid block in the same section as your Collection Bundle:

<div style="margin: 20px 0;">  <label for="embroidery" style="display: block; margin-bottom: 8px; font-weight: bold;">    Embroidery Text  </label>  <input     type="text"     name="properties[Embroidery]"    placeholder="Enter your text here"    style="width: 100%; padding: 10px; border: 1px solid #ccc; border-radius: 4px;"  ></div>

The input must use name="properties[YourPropertyName]" format.


Multiple Properties

Add multiple inputs with different property names:

<div style="margin: 20px 0;">  <label style="display: block; margin-bottom: 8px; font-weight: bold;">Embroidery Text</label>  <input type="text" name="properties[Embroidery]" placeholder="Enter name"></div><div style="margin: 20px 0;">  <label style="display: block; margin-bottom: 8px; font-weight: bold;">Thread Color</label>  <select name="properties[Thread Color]">    <option value="Gold">Gold</option>    <option value="Silver">Silver</option>    <option value="Navy">Navy</option>  </select></div>

Where Properties Appear

  1. Cart — On the parent bundle product

  2. Order confirmation — On each individual bundle item

  3. Shopify Admin orders — On each line item for fulfillment


JavaScript API

For apps that add properties programmatically:

<script>  document.querySelector('.collection-bundle-container').dataset.parentAttributes =     JSON.stringify([      { key: 'Embroidery', value: 'John Smith' },      { key: 'Thread Color', value: 'Gold' }    ]);</script>

Notes

  • Properties starting with _, the "Bundle Items" summary, and empty values are automatically excluded

  • Custom properties are not transferred to free gifts

  • This feature is currently Collection Bundles only (not Mix & Match or Pack Builder)


Related Articles

Did this answer your question?