Skip to content

Swatches on collection pages

Show swatches under each product in a collection grid

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/collection-swatches.md. Walk me through swatches on collection pages 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/collection-swatches.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. Adding it
  2. What it shows
  3. Settings
  4. When nothing appears

Swatches on collection pages let a shopper see that a product comes in other colors without opening it, and switch to one directly from the grid. It is a separate theme block from the product page one, so it has to be added to your collection template.

Adding it

The block goes inside the product card of your collection grid, so it can only be added on themes whose product cards accept app blocks, such as Horizon and other recent Shopify themes.

  1. From the app's home page, open the setup guide step Show swatches on your collection pages and click Open the collection page in the theme editor (or go to Online Store › Themes › Customize and open a collection page).
  2. In the left sidebar, select a Product card inside the product grid.
  3. Click Add block, open the Apps tab and choose Collection Swatches.
  4. Drag it to where you want it on the card (for example under the price), then click Save.

Add it to the card, not as a section of its own: a block added at the bottom of the page draws nothing on the cards.

Dawn and older themes: their product cards don't accept app blocks, so the collection swatches can't be added there. The product page swatches still work on every theme.

What it shows

For a product in a combined listing, it shows the other products in that listing — their colors, or their photos where you have chosen variant images. For a plain product with variants, it shows those variants.

Hovering a swatch swaps the card's image to that color, so a shopper sees the change without leaving the page. Clicking takes them to that product, or to that variant.

Settings

  • Maximum swatches visible — how many fit before a +N badge takes over. Five suits most grids at the default size; more than that tends to wrap onto a second line and push the card's text down.
  • Swatch size, shape and alignment — match these to your theme's cards. Alignment matters most: themes that centre their card text usually want centred swatches.

The card's own product always appears first and is never pushed out by the limit, so the swatch matching the photo is always on screen.

When nothing appears

The block draws nothing when there is nothing to draw: the product is not in a listing, has no variants worth showing, and has no swatch data. In the theme editor you will see a placeholder saying so; on the live storefront the space is simply empty.

An option set to Dropdown cannot render as a control on a card, so it falls back to showing the products' photos, or their names where there are no photos.

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.