Product Catalog

Products #

Each product in the catalog has the following fields:

Each product also supports a per-product low-stock threshold. When set, this value overrides the store-wide low-stock warning level for that specific product, allowing you to configure stricter or looser warnings on a product-by-product basis.

Variants #

A single product can have multiple variants representing combinations of options such as size and color. Each variant has its own:

• Price — can differ from the base product price and from other variants.
• Stock level — tracked independently per variant.
• SKU — unique identifier per variant.

Color swatches are rendered automatically on both the product detail page and the category listing page whenever a variant option is named "Color". Swatches let shoppers see and select available colors without opening a dropdown.

Categories #

Categories are organized in a nested tree with unlimited depth, so you can create hierarchies as deep as your catalog requires (e.g. Clothing > Men's > Jackets). Key behaviors:

• Featured categories — categories flagged as featured appear in the homepage categories section.
• Breadcrumbs — every category page and product detail page shows a breadcrumb trail reflecting the full category path.
• Descendant queries — when a parent category is browsed, products from all child and descendant categories are included in the results automatically.

Product Detail Page #

The product detail page provides everything a shopper needs to evaluate and purchase a product:

• Image gallery — multiple product images displayed in a scrollable gallery with a full-screen lightbox on click.
• Variant selector — color options are shown as swatches; other option types (size, material, etc.) use text buttons. Selecting a variant updates the price, stock badge, and available images immediately.
• Out-of-stock handling — when a selected variant is out of stock, the add-to-cart button is replaced with a back-in-stock notification form so the shopper can request an email when stock is restored.
• Dynamic pricing — the displayed price updates instantly when the shopper selects a different variant.
• Stock badge — a visible indicator shows whether the selected variant is in stock, low in stock, or out of stock.
• Quantity selector — shoppers can set the desired quantity before adding to cart.
• Add to cart — adds the item to the cart without a page reload (AJAX); the mini-cart drawer updates to reflect the new item.
• Wishlist toggle — a heart icon lets signed-in customers and guests save the product to their wishlist.
• Related products — a curated or automatically generated row of related products is shown below the main product content.
• Reviews — the product's customer reviews are listed on the page along with a form for submitting a new review.
• Structured data — the page includes JSON-LD markup (Product, Offer, AggregateRating) for Google Shopping and rich search results.

Category Listing Page #

The category listing page shows all products in a category as a paginated grid.

• Filter sidebar — shoppers can narrow results by variant option (e.g. color, size), price range, in-stock toggle, and sort order (price ascending/descending, newest, relevance).
• Pagination — results are split across pages; the number of products per page is configurable.
• Category description — an optional rich-text description is shown at the top of the page, useful for SEO and merchandising.
• Breadcrumbs — the current category path is shown at the top of the page.