Common issues
Solutions for frequently encountered problems
On this page
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:
- Refresh the page after a minute
- If the status is still stuck, toggle the listing to Draft, save, then set it back to Active
- 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:
- Open the app's home page once, so the pixel is set up
- In Shopify, go to Settings › Customer events › App pixels and check that the Swatches & Listings pixel shows Connected
- 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.
Thanks, that helps us improve this guide.
Contact the Swatches & Listings team
Still stuck? The people who build Swatches & Listings answer support themselves. A person replies, usually within one business day.