Product Discounts - Targeting Strategies

Advanced techniques for selecting which products receive discounts.

Targeting Overview

Product discounts support multiple targeting strategies:

Direct Targeting: IDs, handles, vendors (simple, fast)
Selector-Based: JMESPath/filters (flexible, powerful)
Combination: Mix multiple strategies

Direct Targeting Methods

By Product Handle

Target specific products by URL-friendly handle:

{
  "handles": ["cool-t-shirt", "awesome-jeans"]
}

When to use:

Known product handles
Small, specific product sets
Performance-critical scenarios

By Variant ID

Most specific targeting method:

{
  "variant_ids": [12345678, 87654321]
}

When to use:

Specific sizes/colors
Exact variant targeting
Integration with external systems

By Vendor

All products from specific brands:

{
  "vendors": ["Nike", "Adidas", "Puma"]
}

When to use:

Brand-specific sales
Vendor agreements
Multi-brand discounts

By Variant Title

Target by size, color, or other options:

{
  "variant_titles": ["Large", "X-Large", "XX-Large"]
}

When to use:

Size-specific discounts
Color-based pricing
Option-based sales

Selector-Based Targeting

Use selector parameter with JMESPath or filter syntax for complex queries.

Basic Selector

{
  "selector": "cart.lines[?merchandise.product.handle=='t-shirt'].id"
}

Returns array of line IDs where product handle is ‘t-shirt’.

Collection-Based Selection

Target all items in a collection:

{
  "facts": {
    "sale_items": "cart.lines[?merchandise.product.collections[?handle=='sale']].id"
  },
  "events": [
    {
      "discount": "product_discount",
      "params": {
        "selector": "$sale_items",
        "discount_type": "percentage",
        "value": 25
      }
    }
  ]
}

How it works:

Query finds lines where product is in ‘sale’ collection
Extracts line IDs
Applies discount to those lines

Tag-Based Selection

Target products with specific tags:

{
  "facts": {
    "clearance_items": "cart.lines[?merchandise.product.tags[?@ == 'clearance']].id"
  },
  "events": [
    {
      "discount": "product_discount",
      "params": {
        "selector": "$clearance_items",
        "discount_type": "percentage",
        "value": 50
      }
    }
  ]
}

Price Range Selection

Target products in specific price range:

{
  "facts": {
    "premium_items": "cart.lines[?merchandise.priceV2.amount >= `100`].id"
  },
  "events": [
    {
      "discount": "product_discount",
      "params": {
        "selector": "$premium_items",
        "discount_type": "fixed_amount",
        "value": 20,
        "message": "$20 Off Premium Items"
      }
    }
  ]
}

Multiple Criteria Selection

Combine multiple conditions:

{
  "facts": {
    "targeted_items": "cart.lines[?merchandise.product.vendor=='Nike' && merchandise.product.collections[?handle=='sale']].id"
  },
  "events": [
    {
      "discount": "product_discount",
      "params": {
        "selector": "$targeted_items",
        "discount_type": "percentage",
        "value": 30
      }
    }
  ]
}

Targets: Nike products that are also in the sale collection.

Selector Syntax Reference

JMESPath Filtering

"cart.lines[?{condition}].id"

Common conditions:

merchandise.product.handle == 'value': Exact match
merchandise.product.vendor == 'Nike': Vendor match
merchandise.priceV2.amount >= 100“: Price comparison
merchandise.product.tags[?@ == 'sale']: Array contains
merchandise.product.collections[?handle=='sale']: Nested array query

Custom Filter Syntax

Alternative to JMESPath:

"cart.lines | select(merchandise.product.handle == 'shirt') | map(id)"

Filters:

select(): Filter items
map(): Extract property
sum(): Aggregate values

Targeting Decision Guide

Need to target...
├─ Specific known products?
│  └─ Use: handles or variant_ids
├─ All from a brand?
│  └─ Use: vendors
├─ Products in a collection?
│  └─ Use: selector with collection query
├─ Products with specific tags?
│  └─ Use: selector with tag query
├─ Products by price range?
│  └─ Use: selector with price filter
└─ Complex multi-criteria?
   └─ Use: selector with combined conditions

Performance Considerations

Fastest (use when possible)

variant_ids: Direct ID lookup
handles: Simple string match
vendors: Indexed field lookup

Moderate

selector with simple conditions: Single field filter

Slower (use when necessary)

selector with nested queries: Collection/tag traversal
selector with multiple conditions: Complex logic

Optimization tips:

Cache selector results in facts
Use direct targeting when product set is known
Test with realistic cart sizes

Advanced Patterns

Exclude Products

Target all except specific products:

{
  "facts": {
    "discountable_items": "cart.lines[?merchandise.product.handle != 'gift-card'].id"
  },
  "events": [
    {
      "discount": "product_discount",
      "params": {
        "selector": "$discountable_items",
        "discount_type": "percentage",
        "value": 10
      }
    }
  ]
}

Metafield-Based Targeting

Target using custom metafields:

{
  "facts": {
    "b2b_items": "cart.lines[?merchandise.product.metafields[?namespace=='custom' && key=='b2b_eligible'].value == 'true'].id"
  },
  "events": [
    {
      "discount": "product_discount",
      "params": {
        "selector": "$b2b_items",
        "discount_type": "percentage",
        "value": 25,
        "message": "B2B Wholesale Pricing"
      }
    }
  ]
}

Conditional Targeting

Different products based on customer:

{
  "rules": [
    {
      "conditions": {
        "customer.tags": { "includes": "VIP" }
      },
      "facts": {
        "vip_items": "cart.lines[?merchandise.product.vendor == 'Premium Brand'].id"
      },
      "events": [
        {
          "discount": "product_discount",
          "params": {
            "selector": "$vip_items",
            "discount_type": "percentage",
            "value": 30
          }
        }
      ]
    }
  ]
}

Next Steps

Advanced Features - Dynamic values, quantity breaks, value_case
Examples - Complete real-world configurations
Facts System - Deep dive into selectors

Getting Started

Function Types

Advanced Features

Targeting

Product Discounts - Targeting Strategies

Targeting Overview

Direct Targeting Methods

By Product Handle

By Variant ID

By Vendor

By Variant Title

Selector-Based Targeting

Basic Selector

Collection-Based Selection

Tag-Based Selection

Price Range Selection

Multiple Criteria Selection

Selector Syntax Reference

JMESPath Filtering

Custom Filter Syntax

Targeting Decision Guide

Performance Considerations

Fastest (use when possible)

Moderate

Slower (use when necessary)

Advanced Patterns

Exclude Products

Metafield-Based Targeting

Conditional Targeting

Next Steps

​Product Discounts - Targeting Strategies

​Targeting Overview

​Direct Targeting Methods

​By Product Handle

​By Variant ID

​By Vendor

​By Variant Title

​Selector-Based Targeting

​Basic Selector

​Collection-Based Selection

​Tag-Based Selection

​Price Range Selection

​Multiple Criteria Selection

​Selector Syntax Reference

​JMESPath Filtering

​Custom Filter Syntax

​Targeting Decision Guide

​Performance Considerations

​Fastest (use when possible)

​Moderate

​Slower (use when necessary)

​Advanced Patterns

​Exclude Products

​Metafield-Based Targeting

​Conditional Targeting

​Next Steps

Product Discounts - Targeting Strategies

Targeting Overview

Direct Targeting Methods

By Product Handle

By Variant ID

By Vendor

By Variant Title

Selector-Based Targeting

Basic Selector

Collection-Based Selection

Tag-Based Selection

Price Range Selection

Multiple Criteria Selection

Selector Syntax Reference

JMESPath Filtering

Custom Filter Syntax

Targeting Decision Guide

Performance Considerations

Fastest (use when possible)

Moderate

Slower (use when necessary)

Advanced Patterns

Exclude Products

Metafield-Based Targeting

Conditional Targeting

Next Steps