Skip to content

Common issues

Solutions for frequently encountered problems

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.

Find the cause

Read https://help.pasilobus.com/combined-listings/common-issues.md. On my store, <describe what you see, and on which page>. Using that article, tell me what to check first and what to try next, one step at a time. My theme is <theme name>.

Draft a message to our team

Read https://help.pasilobus.com/combined-listings/common-issues.md. I tried <what you tried> and Swatches & Listings still isn't right on <your-store>.myshopify.com. Write a short message to the Pasilobus support team with what I see and what I tried.

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. Duplicate Option Value Error
  2. Missing Option Values
  3. Products Not Appearing in the Picker
  4. Sync Status Stuck
  5. Plan Limit Reached
  6. Analytics Shows 0 Views
  7. Option Values Not Showing Colors
  8. A Product Shows Text Instead of Swatches
  9. Hiding Sold-Out Products

Solutions for frequently encountered problems when using Swatches & Listings.

Duplicate Option Value Error

Problem: When saving a listing, you see an error about duplicate option value combinations.

Cause: Two or more products in the listing have the same values for all options. Each product must have a unique combination.

Fix: Review the option values assigned to each product and change one so that every product has a distinct combination. For example, if two products both have Color = Red and Size = Large, change one of them.

Missing Option Values

Problem: You see an error that a product is missing a value for one of the listing's options.

Cause: Every product in a listing must have a value for every option. If the listing has Color and Size options, each product needs both a Color value and a Size value.

Fix: Open the listing editor and fill in the missing option values for the flagged products.

Products Not Appearing in the Picker

Problem: When clicking Add Products, some products do not appear in the search results.

Cause: The product picker searches your Shopify catalog. Products may not appear if they are in Draft status or not available on the Online Store sales channel.

Fix: Go to Shopify Admin › Products, ensure the product is Active and available on the Online Store channel, then try the picker again.

Sync Status Stuck

Problem: A listing shows a "Syncing" status that does not complete.

Cause: Background sync jobs occasionally stall, especially for listings with many products.

Fix:

  1. Refresh the page after a minute
  2. If the status is still stuck, toggle the listing to Draft, save, then set it back to Active
  3. This triggers a fresh sync

Plan Limit Reached

Problem: You cannot create new listings and see a message about reaching your plan limit.

Cause: Each plan has a maximum number of listings. When you reach the limit, the Create button is disabled.

Fix: Either upgrade to a plan with a higher listing limit, or delete listings you no longer need to free up space. Draft listings count toward the limit.

A CSV import follows the same limit: rows that would create a listing past it are reported as failed on the import results page, while rows that update listings you already have still go through.

Analytics Shows 0 Views

Problem: The Analytics page stays at 0 views although shoppers are visiting your product pages.

Cause: Views are counted on every plan, Free included, by the app's web pixel. The pixel is set up when you first open the app's home page, and it only counts a visit when the shopper's privacy choices allow analytics (a shopper who declines in your cookie banner is not counted).

Fix:

  1. Open the app's home page once, so the pixel is set up
  2. In Shopify, go to Settings › Customer events › App pixels and check that the Swatches & Listings pixel shows Connected
  3. Visit a product page in a normal browser window, accept analytics in the cookie banner if your store shows one, then reload Analytics

The same views drive Most viewed first swatch order and the Most popular badge.

Top Products lists your most-viewed products whether or not they are in a listing, and shows under each one the listing it belongs to (or Not in a listing). Both Top Products and Top Listings count the date range you pick, the same as the views total beside them, and so does Unique Visitors. A product you have since deleted in Shopify shows as Deleted product, with its views kept.

Option Values Not Showing Colors

Problem: Color Swatch display shows plain squares without color.

Cause: The option values do not have hex color codes assigned.

Fix: Go to the Options page, open the option, and edit each value to add a hex color code (e.g. #FF0000 for red). Save the changes and the swatches will display the assigned colors.

A Product Shows Text Instead of Swatches

Problem: A product's colors appear as a list or as text buttons, even though the app shows its colors as set up.

Cause: Shopify only draws color swatches for products that have a product category. The scan skips products without one, and the swatches page warns about them after you match colors.

Fix: In Shopify, open the product and set its Category (for example Apparel & Accessories > Clothing > Shirts & Tops). Then run Scan my catalog again from the app's home page. The number of products still missing a category is also shown under Settings › Swatches.

Hiding Sold-Out Products

Problem: You don't want shoppers to see swatches for products that are out of stock.

Fix: Turn on Hide out-of-stock products by default under Settings › Swatches. Every listing follows it unless you change Hide out of stock on that listing's own page.

Contact the Swatches & Listings team

Still stuck? The people who build Swatches & Listings answer support themselves. A person replies, usually within one business day.

Include your store's .myshopify.com address and what you've tried. There's no live chat.