Before you begin
Line-item highlights add information beneath items. They do not add products to an order. Choose a highlight placement supported by the page you want to use, and install its matching Shopify app block. Checkout placements require Shopify Plus.
Add your highlights
- Open Upsell Strategies.
- Create a strategy with a line-item highlight placement, or open an existing one.
- Choose its markets and Customer Segment.
- Under What to highlight, select Add highlight.
- Choose a source from the table below.
- Configure its wording, property or metafield, when required, and its supported appearance.
- Optional: open Show on to choose which items in a matching order get this highlight.
- Select Done to keep the highlight in the strategy draft.
- Add or reorder any other highlights.
- Save the strategy.
Closing a highlight's settings without selecting Done discards that dialog's changes. Done does not replace saving the strategy. A strategy can hold up to 10 highlights.
Choose a source
Source | What it shows |
|---|---|
Custom text | The same wording on each item. |
Calculated savings | Savings compared with the item's compare-at price, only for items on sale. |
Original price | The compare-at price as crossed-out text, when available. |
Vendor | The product's vendor. |
Product type | The product's type. |
Line item property | The selected property saved on that item, including a hidden property. |
Metafield text | The value of a product or variant metafield you choose. |
Metafield image | A small image from a product or variant file metafield you choose. |
Only display properties and metafields that are suitable for customers to read. A missing value or an item without a sale price can correctly leave a highlight empty.
Show a metafield
- Choose Metafield text or Metafield image as the source.
- Select Choose metafield, then pick a product or variant metafield from Choose a text metafield or Choose an image metafield.
- For Metafield image, choose a Size: Small, 32 pixels or Medium, 48 pixels.
- Select Done.
To use a different metafield later, select Change metafield.
Metafield text shows up to 120 characters. A date shows as a readable date, and a list shows its first entry. An item whose product or variant has no value for the metafield shows nothing for that highlight.
Choose which items receive a highlight
Two settings work together:
- The strategy's Customer Segment decides which orders receive the highlights.
- Each highlight's Show on decides which items in a matching order get it.
Show on | Which items get the highlight |
|---|---|
All items | Every item where the source has something to show. This is the default, so existing highlights do not change. |
Selected products | Only the products you choose with Select products, up to 50. |
Products with these tags | Only products with at least one of the tags you add under Product tags, up to 20. Tag matching ignores capital letters. |
For example, to show "Final sale" on the one item tagged final-sale instead of every item in the order, add a Custom text highlight and set Show on to Products with these tags with final-sale.
The Show on summary shows your choice, such as All items or Tagged final-sale. There is no global enable switch to find.
Highlights appear in the order you set. Remove a highlight from the strategy when you no longer want to show it.
Check the result
Preview the strategy with representative items. The preview uses each sample product's own tags and metafield values, so a sample product without a value shows nothing for that highlight. Confirm the installed block on the intended page. For checkout, add suitable items to a cart and continue to checkout without placing an order. Check one item with the required source data and another without it. If you use Show on, also check an item that should not get the highlight.
If nothing appears, check the strategy's status, market, customer targeting, placement installation, each highlight's Show on setting and source values. Product-card metafield decorations are separate from these highlights.
