Catalog

Recipes for the product catalog: listings and filters, search, variants, prices, reviews, and cross-selling.

Product Listing and Filters

Understand why one listing response answers every listing concern, how the initial and applied listings differ, why filter option counts do not shrink, and what loadMore keeps from the previous page.

Prices and Tax State

Understand why no price arithmetic belongs in the frontend, which of a product's several prices to show, how the shared formatter follows the currency but not the locale, and what a list price without a percentage means.

Search and Suggest

Which of the two Store API search operations the composables actually run, how much state the suggest dropdown shares with the results page, why the term on the ref always wins, and what useProductSearch really does.

Product Reviews

Understand why the rating average needs no request, what it takes to get a usable review total, why your own review comes back unapproved, and what addReview cannot set.

Product Variants

Understand why resolving a variant is a filtered product search rather than the find-variant operation, why the result carries almost no fields, what the selection map is keyed by, and when merging beats navigating.

Cross-Selling

Understand why the operation accepts no criteria at all, which composable options are ignored, why the response is a bare array, and when a CMS product page already has the data.