Skip to content

Creating your first listing

Create a combined listing with options and products step by step

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/combined-listings/creating-a-listing.md. Walk me through creating your first listing in Swatches & Listings 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/combined-listings/creating-a-listing.md. Answer this about Swatches & Listings on my store: <your question>.

Ask Shopify Sidekick

In your Shopify admin, ask Sidekick about Swatches & Listings. 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 combined-listings summary

Count the store's combined listings, grouped products and swatches

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

On this page
  1. Step 1: Start a New Listing
  2. Step 2: Name the Listing
  3. Step 3: Add Options
  4. Step 4: Add Products
  5. Step 5: Assign Option Values
  6. Step 6: Save and Activate

A listing groups related products together and lets customers switch between them using options like Color, Size, or Material. Each product in the listing is a separate Shopify product, but they appear connected on the storefront through shared option selectors.

Step 1: Start a New Listing

From the dashboard, click Create listing. This opens the listing form.

Step 2: Name the Listing

Enter a name in the Listing name field. This is for your reference in the dashboard and does not appear on the storefront. Choose something descriptive, like "Classic T-Shirt" or "Leather Wallet Collection".

Step 3: Add Options

Options define how customers choose between products. For example, a Color option lets them pick Red, Blue, or Green.

  1. Click Add option in the Options section
  2. Enter an option name (e.g. "Color")
  3. Select a Display type to control how it appears on the storefront:
    • Dropdown – a select menu with product previews
    • Radio Buttons – clickable list items
    • Text Swatch – pill-shaped buttons showing the value text
    • Color Swatch – small color squares
    • Image Swatch – product image thumbnails
  4. Optionally select a different Mobile display type for small screens

For a single differentiator (just Color, or just Size), one option is enough.

Step 4: Add Products

  1. Click Add products in the Products section
  2. The Shopify product picker opens – search and select the products you want to combine
  3. Each selected product appears in the form with fields for its option values

Step 5: Assign Option Values

For each product, fill in the value for every option. For example, if your option is "Color":

  • Product A: Red
  • Product B: Blue
  • Product C: Green

Each product must have a unique combination of values across all options. If you have two options (Color and Size), no two products can share the same Color + Size pair.

For Color Swatch display types, you can also set a hex color code using the color picker next to the value field.

Step 6: Save and Activate

Click Save to create the listing. New listings start Active: the app syncs the listing to Shopify and it shows on your storefront within a moment. To keep it hidden while you work on it, set its status to Draft on the listing's page.

Products keep the order you add them in. Visit any of the listing's product pages to see the swatches in action.

Tips:

  • Start with two or three products to get familiar with the flow before building larger listings.
  • If you are unsure which display type to choose, Dropdown works well as a starting point for any option.
  • You can always edit a listing later to add more products or change display types.

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.