# Common issues

> Solutions for frequently encountered problems

Source: https://help.pasilobus.com/combined-listings/common-issues
App: Swatches & Listings (on the Shopify App Store as "Pasilobus Swatches & Listings")
Shopify App Store: https://apps.shopify.com/combined-listings-pasilobus
App help: https://help.pasilobus.com/combined-listings
Section: Troubleshooting
Last updated: 2026-02-16
Support: email support@pasilobus.com or send a request from https://cloud.pasilobus.com/support (no chat)

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.
