Skip to content

Options and display types

Choose how customers pick between products in a listing

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/options-and-display-types.md. Walk me through options and display types 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/options-and-display-types.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. What Are Options?
  2. Display Types
  3. Mobile Display Type
  4. Managing Options

Options define how customers choose between products in a listing. Each option has a name (like "Color" or "Size") and a display type that controls how the choices appear on the storefront.

What Are Options?

An option represents a single attribute that varies across the products in a listing. Common examples:

  • Color – Red, Blue, Green
  • Size – Small, Medium, Large
  • Material – Cotton, Polyester, Silk

When a listing has multiple options, customers see a separate selector for each one. The combination of selected values determines which product is shown.

Display Types

Each option has a display type that controls how values appear on the storefront. You can choose a different display type for desktop and mobile.

A select menu that opens when clicked. Each item shows the product image alongside the value text. Best for options with many values or when product previews are helpful.

Radio Buttons

A vertical list of clickable items. Each value is displayed as a selectable row. Best for a small number of text-based options where all choices should be visible at once.

Text Swatch

Pill-shaped buttons displayed inline. Each button shows the value text. Best for short text values like sizes (S, M, L, XL) or simple labels.

Color Swatch

Small square color tiles. Each swatch displays a solid color based on the hex code assigned to the value. Best for color options where a visual preview is more useful than text.

Image Swatch

Small image thumbnails arranged inline. Each swatch shows the product's image. Best for options where the visual difference between products is the main differentiator, like patterns or styles.

Mobile Display Type

Each option can use a different display type on mobile devices. This is useful when a display type that works well on desktop takes up too much space on a small screen. For example, you might use Image Swatch on desktop but switch to Dropdown on mobile.

If no mobile display type is set, the option uses the same display type on all screen sizes.

Managing Options

Options are shared across your account. When you create an option in one listing, it becomes available for other listings too.

Viewing All Options

Go to the Options page from the navigation menu to see all options across your store. Each option shows its display type, number of values, and how many listings use it.

Editing an Option

You can edit an option's name, display type, and mobile display type. Changes to display type affect all listings that use the option.

Option Values

Each option has a list of values. Values can include:

  • Text – the label shown to customers (required)
  • Color – a hex color code for Color Swatch display (e.g. #FF0000)
  • Image – an image URL for Image Swatch display

You can add and edit values from the option detail page. Values that are in use by products cannot be deleted.

Tips:

  • Use Color Swatch for color options and Text Swatch for size options as a starting point.
  • If an option has more than 6-8 values, Dropdown keeps the page clean on both desktop and mobile.
  • Option names appear as labels above the selector on the storefront, so keep them short and clear.

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.