Line Item Highlights
desc - Display fixed text badges on cart products with customizable styling and positioning.
Overview
Static Line Item Highlights display fixed text badges on products that match specific criteria. Unlike dynamic highlights that calculate values, static highlights show the same text for all matching products. This makes them perfect for category labels, promotional badges, and product status indicators.
AI was used to generate this documentation. Let us know if you find any inaccuracies.
Configuration Options
Basic Settings
Target Products (Required)
- Methods:
- Specific Products (by ID or handle)
- Product Collections
- Product Tags
- Product Type
- Product Vendor
- Price conditions (on sale, free, above/below threshold)
- Inventory conditions (low stock, out of stock)
- Line item properties (has property, property value)
- Best Practice: Use Display Rules to precisely target products
- Note: This is the most critical setting - wrong targeting means wrong products highlighted
Highlight Content (Required)
For static highlights, you'll enter fixed text that appears on all matching products.
Examples:
- "SALE"
- "NEW"
- "BEST SELLER"
- "LIMITED EDITION"
- "FREE GIFT"
- "PRE-ORDER"
- "LOW STOCK"
Styling Options
Badge Style
Creates a colored badge/pill shape around your text, making it stand out prominently.
Visual Effect: Colored background with rounded corners Best For: High-visibility labels that need to catch attention Inherits: Your checkout's "Pill" or "Badge" style settings
Text Style
Displays the highlight as plain text without a background container.
Visual Effect: Styled text inline with product information Best For: Subtle information that doesn't need to dominate Style Properties:
- Text color
- Font weight (bold, regular)
- Font size
- Font style (italic, normal)
Implementation Examples
Example 1: Sale Items Badge
Seen on SIR the Label
Scenario: Show "SALE" badge on all discounted items
Configuration:
Component: Line Item Highlight
Target Products (Display Rules):
- Product has compare-at price
AND
- Compare-at price > current price
Highlight Content: Static Text
Text: "SALE"
Style:
- Badge style: Pill shape
- Background color: #E74C3C (red)
- Text color: #FFFFFF (white)
- Font weight: Bold
- Font size: 12px
- Text transform: UPPERCASE
- Position: Below product title
Mobile: Show (auto-resize for mobile)
Why This Works:
- Red immediately signals a discount
- "SALE" is universally understood
- Badge style makes it prominent
- Automatically targets all sale items
- No manual product selection needed
Example 2: Best Seller Badge
Scenario: Highlight top-selling products
Configuration:
Component: Line Item Highlight
Target Products (Display Rules):
- Product is in collection "Best Sellers"
Highlight Content: Static Text
Text: "⭐ BEST SELLER"
Style:
- Badge style: Pill shape
- Background color: #F39C12 (gold)
- Text color: #FFFFFF (white)
- Font weight: Bold
- Icon: ⭐ (star emoji prefix)
- Position: Above product title
Mobile: Show
Why This Works:
- Gold color suggests premium/popular
- Star icon reinforces the message
- Social proof increases trust
- Collection-based targeting is flexible
- Easy to maintain (just update collection)
Example 3: New Product Badge
Scenario: Mark newly added products
Configuration:
Component: Line Item Highlight
Target Products (Display Rules):
- Product has tag "new"
Highlight Content: Static Text
Text: "NEW"
Style:
- Badge style: Square with slight rounding
- Background color: #3498DB (blue)
- Text color: #FFFFFF (white)
- Font weight: Bold
- Font size: 11px
- Text transform: UPPERCASE
- Position: Inline with product title (before)
Mobile: Show
Why This Works:
- Blue suggests fresh/new
- Small and compact doesn't overwhelm
- Tag-based for easy automation
- Prominent position catches eye
- Easy to manage via tagging workflow
Maintenance Tip: Set up automation to remove the "new" tag after 30 days
Example 4: Free Gift Highlight
Scenario: Mark promotional free items
Configuration:
Component: Line Item Highlight
Target Products (Display Rules):
- Product price = $0
OR
- Product has tag "free-gift"
Highlight Content: Static Text
Text: "🎁 FREE GIFT"
Style:
- Badge style: Pill shape
- Background color: #2ECC71 (green)
- Text color: #FFFFFF (white)
- Font weight: Bold
- Icon: 🎁 (gift emoji prefix)
- Position: Above product title
Mobile: Show
Why This Works:
- Green = positive/bonus
- Gift emoji adds excitement
- "FREE" is a powerful motivator
- Multiple targeting methods catch all free items
- Prominent position celebrates the bonus
Example 5: Low Stock Urgency
Seen on Heybud
Scenario: Create urgency for low-inventory items
Configuration:
Component: Line Item Highlight
Target Products (Display Rules):
- Product inventory ≤ 3
AND
- Product inventory > 0
AND
- Product is not pre-order
Highlight Content: Static Text
Text: "LOW STOCK"
Style:
- Badge style: Pill shape
- Background color: #E67E22 (orange)
- Text color: #FFFFFF (white)
- Font weight: Bold
- Font size: 11px
- Position: Below product title
Mobile: Show
Why This Works:
- Orange creates urgency without being alarming
- Clear, honest messaging
- Motivates faster purchase decision
- Excludes pre-orders (different messaging needed)
- Only shows when truly low stock
Important: Only use if inventory counts are accurate. False urgency damages trust.
Example 6: Limited Edition Badge
Scenario: Highlight exclusive or limited products
Configuration:
Component: Line Item Highlight
Target Products (Display Rules):
- Product has tag "limited-edition"
OR
- Product is in collection "Limited Edition"
Highlight Content: Static Text
Text: "LIMITED EDITION"
Style:
- Badge style: Pill shape
- Background color: #9B59B6 (purple)
- Text color: #FFFFFF (white)
- Font weight: Bold
- Font size: 11px
- Text transform: UPPERCASE
- Position: Above product title
Mobile: Show
Why This Works:
- Purple conveys exclusivity
- Clear messaging about scarcity
- Collection or tag-based targeting
- Increases perceived value
- Creates sense of urgency
Example 7: Pre-Order Status
Scenario: Show pre-order information
Configuration:
Component: Line Item Highlight
Target Products (Display Rules):
- Product has tag "pre-order"
Highlight Content: Static Text
Text: "PRE-ORDER"
Style:
- Badge style: Pill shape
- Background color: #95A5A6 (gray)
- Text color: #FFFFFF (white)
- Font weight: Bold
- Font size: 11px
- Text transform: UPPERCASE
- Position: Below product title
Mobile: Show
Why This Works:
- Gray is neutral and informative
- Sets clear expectations
- Manages customer expectations about shipping
- Simple and clear
- Professional appearance
Additional Option: Consider adding ship date in a dynamic highlight
Example 8: Vendor/Brand Label (Text Style)
Scenario: Display brand name subtly
Configuration:
Component: Line Item Highlight
Target Products (Display Rules):
- Product vendor is not "Store Brand"
AND
- Product vendor is not empty
Highlight Content: Static Text
Text: "[Vendor Name]"
(Or create separate highlights for each vendor)
Style:
- Text style (no badge)
- Text color: #34495E (dark gray)
- Font size: 11px
- Font weight: Regular
- Position: Below product title
Mobile: Show
Why This Works:
- Subtle, doesn't overpower
- Helps customers identify brand
- Excludes store brand (assumed default)
- Text-only style is understated
- Useful for multi-brand stores
Note: For true dynamic vendor display, see Dynamic Line Item Highlights
Position Options
Above Product Title
Best For: High-priority badges that need immediate attention Examples: "BEST SELLER", "FREE GIFT", "LIMITED EDITION"
Inline with Product Title
Best For: Status indicators that are part of the product identity Examples: "NEW", "EXCLUSIVE"
Below Product Title
Best For: Secondary information that supports the main product Examples: "SALE", "LOW STOCK", brand names
Below Product Price
Best For: Information related to pricing or value Examples: Savings amounts, discount percentages
Best Practices Summary
Do's
✅ Keep text to 3-4 words maximum ✅ Reserve badges for truly notable items
Don'ts
❌ Don't use vague text like "SPECIAL" or "ITEM" ❌ Don't add badges to every single product ❌ Don't use tiny text that's hard to read ❌ Don't use too many different badge styles at once
Next Steps
- Back to Overview: Return to the main Line Item Highlights page
- Dynamic Line Item Highlights: Learn about calculated values and dynamic content
- Conditional Rendering: Master Display Rules for precise targeting
- Analytics: Track the performance of your highlights