Product Bundles — RUTHH COD Form & Upsells
Goal and Expected Result
Section titled “Goal and Expected Result”Configure multi-product bundles in Sales Booster → Bundles (/app/sales-booster/bundles) and understand how bundle definitions are validated and projected into the sales-booster/v2 (cod_boosters.v1_snapshot) metafield.
Preconditions
Section titled “Preconditions”- You have access to Sales Booster → Bundles (
/app/sales-booster/bundles). - The products you want to bundle are active in your Shopify catalog.
Numbered Instructions
Section titled “Numbered Instructions”1. Create a Bundle Definition
Section titled “1. Create a Bundle Definition”- Navigate to Sales Booster → Bundles (
/app/sales-booster/bundles). - Click Create bundle and enter a bundle title, subtitle, and promotional badge.
- Select the component products and variants using the Shopify Resource Picker.
2. Configure Bundle Pricing & Variant Rules
Section titled “2. Configure Bundle Pricing & Variant Rules”- Choose how bundle pricing is calculated (percentage discount or fixed bundle price in your shop currency minor units).
- Specify whether buyers can choose variants for multi-variant bundle items or if specific variants are locked.
- Set the bundle status (Enabled / Disabled) and position order.
- Click Save in the SaveBar. Under the shared
:sales-boostertransactional lock,projectSalesBoosterSnapshotV2updatescod_boosters.v1_snapshot(schemaVersion: "sales-booster/v2") withbundlesRevisionandpublicationRevision.
Warnings and Edge Cases
Section titled “Warnings and Edge Cases”- Snapshot Size Budget:
cod_boosters.v1_snapshotenforces a strict120 KiBceiling (STOREFRONT_SNAPSHOT_MAX_BYTES) and never truncates silently. Keep bundle descriptions concise so combined Bundles and One-Tick Upsells remain well within the budget. - Inventory & Availability: Every component variant in a bundle must be valid and in stock in Shopify at the time of server pricing.
Troubleshooting Steps
Section titled “Troubleshooting Steps”- Bundle changes do not trigger a metafield re-publish: The publication worker only increments and publishes
cod_boosters.v1_snapshotwhen the projected payload of enabled offers actually changes. Saving a disabled bundle without changing enabled offers keeps the published snapshot byte-identical.