Spree Catalog

Before writing code

Fetch live docs:

1. Fetch https://spreecommerce.org/docs/developer/core-concepts/architecture — catalog model graph.
2. Web-search spree meilisearch faceted search v5.4 for the current search backend wiring.
3. Inspect the live Spree::Product / Spree::Variant source for column names — they shift between minors.
4. Check the latest release notes for any new catalog features (CSV importer scope, Page Builder Product Details Page sections, etc.).
5. For PriceList specifics, fetch the latest pricing-related guide on spreecommerce.org/docs.

Conceptual Architecture

Product vs Variant

• Product — the catalog entity (T-shirt, novel, subscription box). Has a master_variant.
• Variant — the sellable SKU. Even simple products have one master variant; products with options have additional variants per OptionValue combination.