---
title: "How to Add Line-Item Highlights"
description: "Show helpful text, savings or product details beneath items using a line-item highlight strategy."
url: https://docs.orderediting.com/en/articles/15323750-how-to-add-line-item-highlights
collection: "Placement Setup Guides"
updated: 2026-11-04
language: en
---

# How to Add Line-Item Highlights

Show helpful text, savings or product details beneath items using a line-item highlight strategy.

# 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

1.  Open **Upsells**.
    
2.  Create a strategy with a line-item highlight placement, or open an existing one.
    
3.  Choose its markets and **Customer Segment**.
    
4.  Under **What to highlight**, select **Add highlight**.
    
5.  Choose a source from the table below.
    
6.  Configure its wording, property or metafield, when required, and its supported appearance.
    
7.  Optional: open **Show on** to choose which items in a matching order get this highlight.
    
8.  Select **Done** to keep the highlight in the strategy draft.
    
9.  Add or reorder any other highlights.
    
10.  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

<table style="min-width: 50px;"><colgroup><col style="min-width: 25px;"><col style="min-width: 25px;"></colgroup><tbody><tr><th colspan="1" rowspan="1"><p>Source</p></th><th colspan="1" rowspan="1"><p>What it shows</p></th></tr><tr><td colspan="1" rowspan="1"><p><strong>Custom text</strong></p></td><td colspan="1" rowspan="1"><p>The same wording on each item.</p></td></tr><tr><td colspan="1" rowspan="1"><p><strong>Calculated savings</strong></p></td><td colspan="1" rowspan="1"><p>Savings compared with the item's compare-at price, only for items on sale.</p></td></tr><tr><td colspan="1" rowspan="1"><p><strong>Original price</strong></p></td><td colspan="1" rowspan="1"><p>The compare-at price as crossed-out text, when available.</p></td></tr><tr><td colspan="1" rowspan="1"><p><strong>Vendor</strong></p></td><td colspan="1" rowspan="1"><p>The product's vendor.</p></td></tr><tr><td colspan="1" rowspan="1"><p><strong>Product type</strong></p></td><td colspan="1" rowspan="1"><p>The product's type.</p></td></tr><tr><td colspan="1" rowspan="1"><p><strong>Line item property</strong></p></td><td colspan="1" rowspan="1"><p>The selected property saved on that item, including a hidden property.</p></td></tr><tr><td colspan="1" rowspan="1"><p><strong>Metafield text</strong></p></td><td colspan="1" rowspan="1"><p>The value of a product or variant metafield you choose.</p></td></tr><tr><td colspan="1" rowspan="1"><p><strong>Metafield image</strong></p></td><td colspan="1" rowspan="1"><p>A small image from a product or variant file metafield you choose.</p></td></tr></tbody></table>

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

1.  Choose **Metafield text** or **Metafield image** as the source.
    
2.  Select **Choose metafield**, then pick a product or variant metafield from **Choose a text metafield** or **Choose an image metafield**.
    
3.  For **Metafield image**, choose a **Size**: **Small, 32 pixels** or **Medium, 48 pixels**.
    
4.  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.
    

<table style="min-width: 50px;"><colgroup><col style="min-width: 25px;"><col style="min-width: 25px;"></colgroup><tbody><tr><th colspan="1" rowspan="1"><p>Show on</p></th><th colspan="1" rowspan="1"><p>Which items get the highlight</p></th></tr><tr><td colspan="1" rowspan="1"><p><strong>All items</strong></p></td><td colspan="1" rowspan="1"><p>Every item where the source has something to show. This is the default, so existing highlights do not change.</p></td></tr><tr><td colspan="1" rowspan="1"><p><strong>Selected products</strong></p></td><td colspan="1" rowspan="1"><p>Only the products you choose with <strong>Select products</strong>, up to 50.</p></td></tr><tr><td colspan="1" rowspan="1"><p><strong>Products with these tags</strong></p></td><td colspan="1" rowspan="1"><p>Only products with at least one of the tags you add under <strong>Product tags</strong>, up to 20. Tag matching ignores capital letters.</p></td></tr></tbody></table>

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.

## Related

- [Setting Up the One-Click Upsell](https://docs.orderediting.com/en/articles/14408304-setting-up-the-one-click-upsell.md)
- [Setting Up Order Status Page Upsells](https://docs.orderediting.com/en/articles/14429370-setting-up-order-status-page-upsells.md)
- [Setting Up Thank You Page Upsells](https://docs.orderediting.com/en/articles/14429369-setting-up-thank-you-page-upsells.md)
- [Setting Up the Free Shipping Upsell](https://docs.orderediting.com/en/articles/13808696-setting-up-the-free-shipping-upsell.md)
- [Setting Up Checkout Upsells](https://docs.orderediting.com/en/articles/13825630-setting-up-checkout-upsells.md)
