How to print line item properties from Shopify orders

What line item properties are

A field on the product page, added by your theme or an app, has a name such as properties[Gift message]. When the shopper adds the item to the cart, what they typed goes with it, and Shopify saves it with that item in the order: a name, Gift message, and a value, the message itself.

<input type="text" name="properties[Gift message]">

On the order page, the properties show under their item. Two of the same product with different properties become separate lines, so each gift keeps its own message.

Properties that start with an underscore

Shopify hides a property from shoppers at checkout when its name starts with an underscore. Apps use these for their own data: Noteable, for example, saves _noteable_template_id with each item, so it knows which card design to print.

They’re still saved with the order, and your templates can read them, so skip them when you print. The snippets on this page do.

Print them on the packing slip

Shopify’s packing slip template has each item’s properties as line_item.properties. Each one has a name, property.first, and a value, property.last.

1. Open the template. In your Shopify admin, go to Settings › Shipping and delivery and click Packing slip template in the Documents section. If Documents lists your document templates instead, click your packing slip template.
2. Find the item loop. It starts with {% for line_item in line_items_in_shipment %}. Paste the snippet inside it, under the item’s title.
3. Preview, then save. Preview the template, save it, and print the packing slip for an order whose items have properties.

{% for property in line_item.properties %}
  {% assign first_char = property.first | slice: 0 %}
  {% if property.last != blank and first_char != "_" %}
    <p>{{ property.first | escape }}: {{ property.last | escape | newline_to_br }}</p>
  {% endif %}
{% endfor %}

It prints each property that has a value, one per line, as its name and value. escape prints characters such as < just as the shopper typed them, and newline_to_br keeps their line breaks.

Print just one property

To print one property, such as the gift message, and leave the others off, compare each name with the one you want. Use the name exactly as it shows on the order page, capitals and spaces included.

{% for property in line_item.properties %}
  {% if property.first == "Gift message" and property.last != blank %}
    <p><strong>Gift message:</strong> {{ property.last | escape | newline_to_br }}</p>
  {% endif %}
{% endfor %}

Change both Gift messages to your property’s name, the one in quotes to match it and the one in bold as its label on the slip.

In Shopify Order Printer

Shopify Order Printer’s templates have the same line_item.properties, but their item loop is {% for line_item in order.line_items %}, so paste either snippet inside that loop. Print from an order with More actions › Print with Order Printer, or select several orders on the Orders page and print them together.

In order notifications

Notification templates, such as the order confirmation, can print properties too. In your Shopify admin, go to Settings › Notifications and open the template. Shopify’s notification variables have each item’s properties as line.properties. Look for them in the template’s item loop before you add anything: the template may print them already.

Why a property doesn’t print

Open the order and look under the item first.

• It’s under the item, but not on the slip. The template doesn’t print properties yet, or its loop skips this one. Add the snippet inside the item loop, and if you print just one property, check that the name matches.
• Its name starts with an underscore. The snippets skip those on purpose: they’re an app’s own data.
• It isn’t under the item. It was never saved with the item. Shopify saves properties from fields inside the product form, so a field that sits outside the form never reaches the order.
• It’s under Notes or Additional details. It was saved for the whole order, as the order note or a cart field, not as a property. The packing slip can print the note but not Additional details: see How to print the gift message on your Shopify packing slip.
• You edited the other template. Shopify’s packing slip and Shopify Order Printer have separate templates, so add the snippet to the one you print.

Questions