Template variables reference

Every variable and helper you can use in a custom template, in one place. Variables pull live order data into your document; helpers format it.

Wrap a variable in double curly braces to print its value: {{order.name}} prints the order number, such as #1042. The same list is available inside the editor: {} Vars opens a picker, and ? Help opens this reference with copy-and-paste examples.

New to custom templates? Start with Custom Templates.

Order#

Money#

Money values come formatted in the order's currency, with its own symbol: a GBP order prints £108.00 and a euro order prints €42.50. Each has a _raw twin, such as {{order.total_price_raw}}, for the plain number.

Once you choose a format under Settings → Language and format, money also follows that region's style, such as 1.234,50 € for Germany. See Language and format.

Taxes and discounts#

Percentages follow your language and format too, so a German format prints 8,25 %.

Addresses#

{{shipping_address.name}}, .company, .phone, .address1, .address2, .city, .province_code, .zip, .country.

{{shipping_address.formatted}} prints the whole address with line breaks. Add white-space: pre-line in your CSS so the breaks show.

Once you choose a format under Settings → Language and format, {{shipping_address.lines}} holds the address lines in the order the destination country expects, such as the postcode before the city for Germany. It leaves out the name and company, so print those first, as in the example below. The country line uses your document language, and .formatted follows the same layout.

<div>{{shipping_address.name}}</div>
{{#ifNotEmpty shipping_address.company}}<div>{{shipping_address.company}}</div>{{/ifNotEmpty}}
{{#if shipping_address.lines}}
  {{#each shipping_address.lines}}<div>{{this}}</div>{{/each}}
{{else}}
  {{#ifNotEmpty shipping_address.address1}}<div>{{shipping_address.address1}}</div>{{/ifNotEmpty}}
  {{#ifNotEmpty shipping_address.address2}}<div>{{shipping_address.address2}}</div>{{/ifNotEmpty}}
  <div>{{shipping_address.city}}, {{shipping_address.province_code}} {{shipping_address.zip}}</div>
  {{#ifNotEmpty shipping_address.country}}<div>{{shipping_address.country}}</div>{{/ifNotEmpty}}
{{/if}}

lines is empty when your store uses the current format, or when Shopify could not send the formatted address, so keep a fallback like the one above.

The same fields exist under {{billing_address.*}}, including .formatted and .lines.

Line items#

Loop over the items in the order:

{{#each line_items}}
  {{this.quantity}} × {{this.title}}
{{/each}}

Outside the loop, {{total_quantity}} is the total number of units and {{line_items.length}} is the number of distinct items.

Line item properties#

Properties are the per-item details a buyer or another app adds at checkout, such as "Gift Wrap: Yes" or an engraving message.

Print them all inside the loop:

{{#each this.custom_attributes}}{{this.key}}: {{this.value}}{{/each}}

Or pull one by name with {{this.custom.<Name>}}. Spaces become underscores, so "Gift Wrap" is {{this.custom.Gift_Wrap}}. Properties whose names start with an underscore belong to other apps and are hidden automatically.

Your company and the customer#

Logos are set under Settings → Branding; the tax ID under Settings → Store information. See Branding & Tax ID.

Accent color: use var(--brand-accent) in your CSS to pick up the accent color from Branding. Brand intensity applies to built-in templates only.

Shipping#

{{shipping.method}}, {{shipping.tracking_company}} (the carrier, such as USPS), {{shipping.tracking_number}}, {{shipping.tracking_url}}.

Fulfillment location#

For shops that ship from more than one Shopify location:

These fill in whenever the document belongs to a known location, including orders that ship entirely from one place. They are empty on invoices for split orders, which always cover the whole order, so they are safe to add to any template. See Multi-Location Printing.

Your store's custom fields#

Order attributes, metafields, and line item properties from your own recent orders appear in the {} Vars picker:

• {{order.custom.<name>}} for order attributes
• {{order.meta.<namespace>.<key>}} for order metafields
• {{this.custom.<name>}} for line item properties, inside the line items loop

Helpers#

Show something only sometimes#

• {{#if settings.showPrices}} … {{/if}}
• {{#ifNotEmpty order.note}} … {{/ifNotEmpty}}
• {{#ifEquals a b}} … {{/ifEquals}}
• {{#if (hasTag this.tags "fragile")}} … {{/if}} checks a product tag

Format values#

Dates and times always use your store's timezone, set in Shopify admin under Settings → General. They print in the date format from Settings → Language and format: 10/6/2026 in the current US format, 06/10/2026 for the United Kingdom, 6.10.2026 for Germany.

formatDate and formatDateOffset accept an ISO date, such as {{order.created_at_raw}}, or a date already in your store's format, such as {{order.created_at}}. So {{formatDateOffset order.created_at 30}} prints the date 30 days after the order. For the exact order time, use {{formatDateTime order.created_at_raw}}.

Barcodes and codes#

Need a variable that is not here? Email support@autoprinter.app and tell us which Shopify field you need.