For the complete documentation index, see llms.txt. This page is also available as Markdown.

Why aren't my groups showing on the storefront?

Almost always one of these. Work down the list:

1

Is the app embed on?

OPTIS renders through an app embed. Go to Online Store → Themes → Customize → App embeds and make sure OPTIS Combined Listings is toggled on, then Save. (Or use Home → Setup guide → Activate the app.)

2

Did you save the group?

Open Group products and confirm the group exists and contains the products you expect. For Auto Groups, check the preview matched at least one product.

3

Are the products active?

Draft and archived products are skipped on purpose. Make sure the products in the group are active and published to the Online Store sales channel.

4

Collection page specifically?

For swatches on collection cards, also: enable Show on collection page in Global settings, and on app-block themes add the OPTIS app block to the product card (Setup guide → Step 3).

5

Hard refresh / clear cache

Storefront changes can be cached. Do a hard refresh (or test in a private window). If you enabled the embed on a draft theme, preview that theme.

6

Theme or page-builder quirks

Themes differ a lot in how they are built. OPTIS already works with 200+ themes, but a few need a small tweak on our side. The same goes for page builder and search & filter apps - they can change how product and collection pages are structured, which sometimes stops swatches from rendering in the right spot. If you've checked everything above and swatches still don't appear (or appear in the wrong place), just contact us and we'll fine-tune the app for your theme.

Still stuck? Check Sync logs to confirm the group synced, then reach us via live chat or support@optis.me - include your store URL and the product page where you expect to see swatches.

Last updated