Line item text

Line item text shows a short line of text under each item in the order summary. Because it knows which item it’s under, it can show that item’s SKU, prices, line item properties, and product or variant metafields.

Available on the Buddy plan. Needs Shopify Plus. Also works on the thank you and order status pages.

Set it up

1. Create a Line item text block and fill in Text, the only setting.

2. Use conditions to choose which items it appears under. The Target line item conditions check the item the text sits under. See target conditions.

3. In the Checkout Editor, add a Cart line item app block to the cart line item spot, under the items in the order summary, and set its Fixed block ID. See the Checkout Editor.

It only works under items

Placed anywhere else, the block has no item to read, so its item variables are empty. You can also use the Checkout Buddy (v1) app block for this spot.

Variables

The text supports dynamic text. Line item text has its own set of variables:

Available	Value
price	The item’s unit price
compareAtPrice	The item’s unit compare-at price, if it has one
lineQuantity	The item’s quantity
lineTotalAmount	The item’s line total
variantSku	The variant’s SKU
line	The item’s properties (line.attributes) and metafields (line.product.metafields, line.variant.metafields)
cartCompareAtPrice	The whole cart at compare-at prices
currencyCode, toMoney()	For formatting money
customer	The logged-in customer’s checkout_buddy.field metafield

Not available here: orderTotal, orderSubtotal, lines, totalDiscountAmount, the delivery estimate variables, and checkoutNotes. Use a content block placed under each item if you need those: its Text part has every live value, and its This item rules pick the items.

See variables for details.

Examples

Discount badge on sale items

{@discountTag {{ Math.round((compareAtPrice - price) / compareAtPrice * 100) }}% OFF}

Add the condition Target line item compare-at price greater than price so the badge only shows on items that are actually on sale.

How much the customer saves on this item

You save {{ toMoney((compareAtPrice - price) * lineQuantity, currencyCode) }}

Original price, struck through

Was {@strikethrough {{ toMoney(compareAtPrice, currencyCode) }}}

Final sale warning with a tooltip

{@!tooltip This item can't be returned or exchanged.} Final sale

Pair it with Target line item tags includes final-sale.

A product metafield

Ships in {{ line.product.metafields.custom.lead_time }}

A line item property

Engraving: {{ line.attributes["Engraving"] }}

Things to know

• Put a metafield namespace or key with a hyphen in brackets: line.product.metafields.custom["size-chart"].
• Guard against empty values so customers don’t see blank or odd text: {{ compareAtPrice ? 'On sale' : '' }}.
• Show the text only under certain items with Target line item conditions. Cart-wide conditions like Line item tags check the whole cart, so the text would show under every item.
• On the thank you and order status pages, the text shows as an item note: price, compareAtPrice, cartCompareAtPrice and product and variant metafields aren’t available there, a discount badge shows as plain text, and tooltips are left out. See checkout blocks on the thank you page.