The Product Collection option type lets customers pick any product from a Shopify collection as a customization choice — without you having to maintain option values manually. The collection’s products and variants are pulled automatically, so when you add or remove products from the collection, the option updates with the next sync. This is ideal for “pick a complementary product” or “build your own bundle” flows.
When to use it
Use Product Collection instead of a regular Dropdown when:
The list of choices is long enough that maintaining option values by hand is painful
The choices are real Shopify products and you want to use their actual prices, inventory, and variants
You want customers to see a product image and title for each choice instead of just text
The selection should appear in the cart as a real product line item, not a custom property
Setting it up
When creating or editing an option, choose Product Collection as the type. The values editor disappears and a single setting appears:
Source collection - click Select collection and pick the Shopify collection whose products should populate the picker. The picker uses the standard Shopify resource picker.
Hide out-of-stock products - when on, products whose variants are all unavailable are filtered out of the picker entirely. When off (default), unavailable products show grayed out and can’t be selected.
That’s it. There are no manual option values, no per-value images, and no pricing fields. Prices come from each variant directly.
How it looks on the storefront
Customers see a styled dropdown showing each product’s thumbnail and title. Clicking opens a scrollable list of all products in the collection. After picking a product:
If the product has one variant, it’s auto-selected and the variant dropdown is hidden
If the product has multiple variants (size, color, panel count, etc.), a second native dropdown appears for variant selection — pre-filled with the first available variant. Customer can change it.
The selected variant is treated as a priced add-on, exactly like any other priced option.
Cart behavior
When the customer adds to cart, the selected variant becomes a separate line item — same as a Dropdown option with a priced value. All other configuration options on the page apply as line-item properties.
If you’ve enabled Merge into main product on the option, the variant line item is bundled with the main product in cart via the Cart Transform Function, so customers see one merged line.
The variant’s price, inventory, and tax behavior come from Shopify directly — there’s no separate pricing setup in the app.
How it stays in sync
Collection contents change automatically. The product list refreshes when:
A product’s price, title, image, or inventory changes (via the existing
products/updatewebhook)The collection’s product membership changes (via the
collections/updatewebhook)
You don’t need to manually re-save the option after changing products in the collection.
Limitations
The picker fetches up to 250 products at a time. Collections larger than that will only show the first 250 — consider splitting into smaller curated collections.
Each product can have up to 100 variants in the picker.
Conditional logic that triggers on this option treats the variant title as the value (e.g., “Hat – Small”).