Product & Variant Eligibility

Bundle Step Eligibility Overview

This configuration defines which items (products or collections) are available for selection within each bundle step.

Each step includes a set of eligible items, and customers can only select from those options.

Item Types (itemType)

Each item added to a step is defined by the Item Type dropdown.

Products (itemType: "product")

• Adds specific products to the step
• All available variants of the product can be selected
• Displayed as a product card with variant selection

Collections (itemType: "collection")

• Adds all products from a selected collection
• Automatically reflects changes made in Shopify
• Ideal for dynamic or frequently updated catalogs

Adding Eligible Items

To configure items for a step:

1. Open the bundle and navigate to the desired step
2. Select the Item Type from the dropdown:
   • Products
   • Collections
3. Click the corresponding action:
   • Add Products
   • Add Collections
4. A popup will open showing available items
5. Select the items you want to include
6. Click Add to confirm

Selected items will be added to the step and become available for customer selection.

Variant Eligibility

• When a product is added, all available variants are eligible by default
• Customers can select from available options (e.g., size, color)
• Out-of-stock variants follow the bundle’s availability settings
• If no restrictions are applied, all valid variants remain selectable

Stored Item Data

Each item stores the following information:

• Shopify GID → Unique identifier
• Title → Product name
• Image URL → Product image
• Handle → Used for product links
• Price (cents) → Stored as fallback value
• Position → Determines order within the step

Uniqueness Rules

• A product cannot be added more than once within the same step
• The same product can be used across multiple steps

Display Order & Sorting

Default Order

Items are displayed based on their configured order.

Sorting Options (sortingOption)

• default → Configured order
• price_asc → Lowest price first
• price_desc → Highest price first
• name_asc → A–Z
• name_desc → Z–A
• newest → Recently added first

Inventory & Availability (hideUnavailableItems)

Controls how unavailable items are handled:

false (default)

• Out-of-stock items are visible but not selectable

true

• Out-of-stock items are hidden completely

Extended Product Data (sendExtendedProductData)

By default, only essential product data is used for performance.

When enabled, additional product data can be included for enhanced functionality.

Important Notes

• Eligibility is configured per step
• Collections update dynamically with Shopify changes
• Product data may change based on store updates (price, inventory)
• Proper setup ensures accurate bundle behavior