Skip to content

Product collection option

Let customers pick a product (and variant) from a Shopify collection as an option

Use with AI

Use with AI

Ready-made prompts Connect your AI to Pasilobus Install the CLI

This page

View as MarkdownPlain text of this page Open in ClaudeAsk about this page Open in ChatGPTAsk about this page

Ready-made prompts

Fill in the parts in angle brackets, then paste into any assistant.

Step by step on your store

Read https://help.pasilobus.com/product-options/product-collection.md. Walk me through product collection option in Product Options for my store, step by step. My theme is <theme name> and I want <what you want to happen>.

Ask your own question

Read https://help.pasilobus.com/product-options/product-collection.md. Answer this about Product Options on my store: <your question>.

Ask Shopify Sidekick

In your Shopify admin, ask Sidekick about Product Options. It searches these guides.

Connect your AI to Pasilobus Beta

Our MCP server lets Claude, ChatGPT, OpenClaw and other MCP clients use your Pasilobus apps. It is in beta and open to every Pasilobus account: you sign in with it when your assistant asks. Tools that change your store are marked as changes, so your assistant asks you first.

https://cloud.pasilobus.com/mcp

In Claude Code, add it, then run /mcp to sign in:

claude mcp add --transport http pasilobus https://cloud.pasilobus.com/mcp

In Claude on the web or desktop, go to Customize › Connectors › Add custom connector and paste the address. In ChatGPT, OpenClaw or another client, add it as a custom connector (MCP) with the same address.

Install the CLI

npm install -g pasilobus

Run your apps from the terminal or a coding agent. These only read, so they are safe to try:

pasilobus product-options groups

List product-option groups, their options and products

pasilobus product-options orders

Recent orders that contain product-option customizations

pasilobus apps lists your apps on the store; pasilobus <app> help lists what each app can do. How it works

On this page
  1. When to use it
  2. Setting it up
  3. How it looks on the storefront
  4. Cart behavior
  5. How it stays in sync
  6. Limitations

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/update webhook)
  • The collection's product membership changes (via the collections/update webhook)

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").

Talk to a person.

The people who build our apps answer support themselves. Send us a message or email us, and a person replies, usually within one business day. There's no chat.