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

Where groups appear

Once the app embed is on, your groups can show in two places.

On the product page (PDP)

The swatch selector appears on every product in a group. Clicking a swatch opens that product's page - with its own images, price, and details.

A combined listing on a product page with color swatches
The group's option selector on the product page

On the collection page

Swatches can also appear on each product card in a collection, so shoppers can preview and switch options without opening the product.

Collection page product cards each showing swatches
Swatches on collection product cards

Turning collection-page display on

  1. In the group, set Show on collection page to Yes and choose a Collection page display style. This is a per-group setting in the group editor (and visible in the Product groups list) - not a global one.

  2. Some themes also need the OPTIS app block added to the collection product card. The Setup guide → Step 3 (Add the app block) walks you through it with a deep link and a visual guide.

Two ways OPTIS renders: on most themes it works automatically through the app embed. On app-block themes (like Horizon), adding the app block to the product card gives the most reliable collection-page rendering.

Last updated