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

Group Product (Set Product) Experience

How set products made up of multiple pieces are listed, selected, and added to the basket in Instore — together with the pricing logic, stock scenarios, and brand-level display settings behind them.

Overview

Some products ("sets" or "bundles") are sold as a single main product but contain several sub-items — for example, a "Sardes Dining Room Set" is made up of a table and chairs, each a separate product. These sub-items are listed at the bottom of the product detail page as individual cards, each with its own image, feature/dimension information, variant (color/size) selection, and its own "Add to Basket" button.

THERE ARE TWO DIFFERENT WAYS TO ADD ITEMS IN THIS EXPERIENCE

(A) Add the full set: The main "Add to Basket" button at the top of the page automatically

turns into "Add to Basket (N Products)" when the product is a set, adding every sub-item

to the basket at its predefined fixed quantity.

(B) Add individually: Each sub-item card further down the page has its own "Add to

Basket" button — here the customer can pick a color/size and choose the quantity to add

just that one sub-item.

The three question groups in this document focus on how these two paths interact with

each other, how prices are calculated, and how stock status changes what's shown on

screen.

End-to-End Flow

Below, the listing, selection, and add-to-basket steps are shown with real screenshots.

2.1 Listing & Card Layout

This view can be turned on or off through brand settings. When enabled, a section titled "Setini Seç" ("Choose Your Set") appears at the bottom of the product detail page. Each sub-item gets its own card, split into four areas: image, feature/dimension information, product options (color/size), and price + add-to-basket.

The screenshots below were captured in a Turkish-language store for this walkthrough; the same page and layout are available in every supported interface language, English included.

2.2 Variant selection

When a card has options such as color or size, they're listed under the "Product Options" heading. Selecting an option makes the card fetch that option's current image, price, and stock status automatically. This update is specific to that card only — see Section 3 for details.

Only the option changed: the struck-through price dropped to 11,429.00 TRY , while the active price stayed the same.Only the "door count" option was changed on this one card — as shown, that alone can genuinely change the price the card displays.

2.3 Adding to basket

Adding individually from a card: The customer picks a quantity with the +/− buttons and clicks "Add to Basket. " If a variant selection is required and hasn't been made, a warning appears above the button instead: "Please select a variant for this product before adding it to the basket."

Adding the full set from the top: The main button at the top of the page adds every sub item in the set at its own fixed quantity.

Pricing Logic

Based on the app's current behavior, here are definitive answers to the two questions on this topic:

3.1 Does selecting a variant (color/size) change the price?

ANSWER: YES, BUT ONLY ON THAT CARD

As soon as a variant is selected, each sub-item card automatically pulls the current price and any promotion tied to that variant. So if the selected color/size is priced differently (say, a larger size costs more, or a color is on promotion), the price shown on that card updates.

3.2 If you add up the sub-item prices, does it match the set price?

ANSWER: THE SET PRICE ISN'T A SEPARATE FIELD — IT'S ALWAYS THE SUM OF THE SUB-ITEMS

Any price that may be set on the main (set) product itself is never shown or used on screen. The total shown at the top of the page is always calculated by multiplying each sub-item's price by its defined quantity within the set, then summing those.

If a sub-item has a basket promotion defined specifically for it, that promotional price is used in the total instead of the regular price for that item. In that case, the normal total is shown struck through at the top of the page, and the promotional total is shown as the active price.

Values are illustrative; actual prices depend on the store catalog.

"Add Full Set" and Adding Individually

4.1 Both paths lead to the same basket

Both paths ultimately use the same add-to-basket action — they're just triggered differently:

4.2 What happens if a customer adds an item individually, then clicks "Add Full Set"?

ANSWER: THERE IS CURRENTLY NO CONTROL THAT PREVENTS THIS

The app does not detect this scenario, warn the customer, or automatically merge anything. If a customer adds a sub-item to the basket individually from its card and then clicks the "Add to Basket (N Products)" button at the top, the add action for that same sub-item runs a second time.

4.3 If a sub-item fails while "Add Full Set" is running

Stock Status Scenarios

Stock is checked at two separate levels, independently of each other: the card level, and the "Add Full Set" level.

5.1 Card level — when the selected variant is out of stock

  • Only that card's "Add to Basket" button becomes disabled, and its label changes to "Out of Stock."

  • The card's image, info area, and price are unaffected and do not fade — only the button and the product options change.

  • An out-of-stock option (color/size) is marked with a faded look and becomes genuinely unclickable — not just styled differently. One exception: if the product team has specifically flagged that option as "selectable even when out of stock," it stays clickable; once selected, its out-of-stock status is still reflected on the button as described above.

  • The upper limit on the quantity buttons is automatically set based on the selected variant's current stock count.

5.2 "Add Full Set" level — when any sub-item is out of stock

ANSWER: IF A SINGLE SUB-ITEM IS OUT OF STOCK, THE FULL-SET BUTTON IS COMPLETELY BLOCKED

This check looks at the stock status of every sub-item as it was when the page first loaded. If any one of them is out of stock, the "Add to Basket (N Products)" button at the top becomes completely disabled and shows "Out of Stock."

Brand-Level Display Settings

What information shows up in the "Product Features" and "Dimensions" areas of the sub-item cards — with what label, and in what order — is controlled by a configuration managed per brand/product type from the Omnitron panel.

Turning this view on or off

The card view can be toggled with a separate brand setting. When it's off, sub-items appear only as a plain list; when it's on, the card experience described in this document (image, feature/dimension info, variant selection, individual add) is enabled.

Configuration fields

Separate rows can be defined per product type/category from the panel. Each row has the following fields:

  • Attribute Set: Determines which product type/category this row applies to. Rows matching a product's own type are used first; if there's no match, the system falls back to rows marked "default" (general). This lets a brand define, say, a different layout for "Furniture" products while every other product type uses the general layout.

  • Attribute Code: Determines which piece of product information (e.g., color, width) is shown on the card.

  • Group / Tab: Determines which area this piece of information appears in. Only two values are valid: Product Features or Dimensions. Any other value means the row won't appear in either area — it's skipped silently, with no error.

  • Order: The display order within the same area (ascending). Left blank, it's moved to the very front.

  • Label Override: The heading text shown on the card. Left blank, the system automatically uses that piece of information's standard/generic name.

PANEL ↔ CARD CORRESPONDENCE (REAL EXAMPLE)

The "Sub-content 1" row above is exactly where the "Material: Particle Board" line comes from — the first line you see in the "Product Features" tab of the wardrobe card in Section 2.2. It appears first because its order is 1, in the "Product Features" area because Group/Tab is set to that, and with that exact label because Label Override was set to "Malzeme" ("Material").

Last updated

Was this helpful?