Product Catalog Management¶
The BadgerCommerce platform provides a robust and flexible product catalog management system designed for multi-tenant ecommerce needs.
Key Features¶
Product Structure¶
- Multi-level Product Hierarchy: Supports parent products with multiple variants
- Flexible Attribute System: Custom attributes can be added to products for categorization and filtering
- SEO-friendly URLs: Products are automatically given SEO-friendly URLs based on product names
- Rich Media Support: Multiple images per product with primary/alternate designation
- Collection Management: Products can be organized into collections for easier navigation. Collections support a parent/child hierarchy, and a collection page surfaces quick links to its child collections — a horizontally scrolling pill row beneath the title (ordered by
displayOrder), led by an "up one level" link to the parent — so shoppers can move down and back up the tree without a full merchandising tree
Inventory Management¶
- Real-time Stock Tracking: Track inventory levels across variants
- Availability Notifications: System automatically handles out-of-stock scenarios
- Inventory Reservation: During checkout, inventory is temporarily reserved
- Multi-warehouse Support: Capable of managing inventory across multiple locations
- Search follows stock: when a SKU sells out or comes back in stock, the search index's In stock filter updates within seconds, with no index write for ordinary sales (see Stock and the In stock filter)
Product Search & Discovery¶
- Advanced Search Engine: Full-text search with faceting capabilities
- Searchable Attributes: Any product attribute can be made searchable
- Auto-suggestions: As customers type, relevant product suggestions appear
- Faceted Navigation: Filter products by attributes, price ranges, collections, etc.
- Filter display per taxonomy attribute: each attribute in the taxonomy chooses how it filters
listings (Catalogue > Taxonomies > Edit > Filters, the REST taxonomy schema, or MCP
manageProductTaxonomy setFilterDisplay):facetDisplayisLIST(the default: values to tick),SWATCH(the same with a colour dot by each value) orRANGE(min and max boxes over the values read as numbers, so40and40mmare both 40; a product matches when any of its values is in the range).unitlabels aRANGEfilter's boxes (mm).swatchesmaps values to colours for aSWATCHfilter, only for values whose name isn't a colour (Midnight = #1f2a44). Values named after a colour (Navy,Light Grey) get one automatically; a colour must be a hex colour or a colour name, anything else is ignored.
- Merchandising Controls: Ability to feature specific products in search results
Product Display¶
- Flexible Display Templates: Different product types can have different display layouts
- Cross-sell and Upsell: Related products can be configured for cross-selling
- Product Bundling: Create bundles of products that can be purchased together
- Customizable Gallery: Product galleries with zoom functionality
- Variant Selection: Easy switching between product variants with instant updates. A variant
disabled in the admin is hidden everywhere a shopper could reach it: the picker (along with any
option value only it carries), search,
?v=links and the basket, which rejects it as an unknown variant. A product whose every variant is disabled shows as out of stock. - Stock line on a product with variants (Nova and the themes built on it): it follows the
variants, never the parent product's own stock record. Before a choice is made it shows the
enabled variants together (Always available if any is untracked, otherwise their total), and
a
?v=link shows that variant's. Picking a variant switches it to that variant's level ("In stock (30 available)", Always available, Out of stock); an incomplete choice goes back to the overall line. The same overall level decides whether Add to basket starts enabled. - Prices on the option buttons (Nova and the themes built on it): when one option group alone decides the price, each of its buttons shows it ("Adult £10", "Under 18 £5"). That means every variant with a given option costs the same and the options don't all cost the same: event ticket types, pack sizes. A group whose options all cost the same, or whose price also depends on another group's choice, shows no prices. Whole amounts drop the pence (£10) unless one of the group's prices has them (£7.50, £10.00). A sold-out option still shows its price.
- Headline price before a choice (Nova and the themes built on it): the product page shows the product's own price, as its listing card does, with From when the options' prices differ. An event's Adult ticket at £10 stays the headline over a £5 Under 18 concession. If no option sells at the product's own price (it was left out of date), the page shows the cheapest option instead. Choosing an option shows the price of what's still possible.
- Was-price and saving with options: the product page's was price and Save N% badges (in
every theme) describe the option chosen. An option is on sale when its compare-at price is above
its price; an option with no compare-at price of its own uses the product's, but only when that is
above the option's price, so a dearer option never reads "was" a smaller amount. A
?v=link renders the same way. Before a full choice, the was-price shows only when every option still possible sells at one price reduced from one was-price; a From price shows none. - Variant options as filter values: a variant option group's options count towards the taxonomy
filter whose id is the group's code. When they differ, the group says which filter it feeds
(
taxonomyAttributeId) and how its options read there (attributeValues, option → filter value; an option not listed counts as itself). On Halden thekitgroup feeds thesupplied-asfilter, with2 x 2.0Ah kitcounting asKit with batteries. Set it under Catalogue > Taxonomies > Edit > Variant options (below the editor) or with MCPmanageVariantGroups setFilterMapping; saving rebuilds the search index. - Colour swatches in the variant picker: Nova's picker puts a colour dot before each option of a colour
group (code
colourorcolor) whose name is a colour word (Navy, Light Grey), read the same way as swatch filters (Swatches). A group'sswatches(option →#hexor colour name) give options their own colours, for names that aren't English colour words (Blanco→#FFFFFF), and setting any turns dots on for a group with another code. Set them with MCPmanageVariantGroups setSwatches; anything that isn't a colour is refused, and only hex colours,clearandmultireach the page. With a colour variant's own images (see the La Camiseta demo), choosing the colour shows both. - Price labels in the variant picker: a group whose options are amounts (a donation ladder of £3, £5,
£10 a month) can have its buttons say each option's price instead of its name, set per group with MCP
manageVariantGroups setOptionLabel(optionLabel:price, orname, the default). The price comes from the variant, in the shop's currency (no pence when every amount is whole), so the option names don't matter, and the buttons go cheapest first. Such a group carries no separate price beside the label. An option whose price depends on another group's choice keeps its name. Other groups still show a price on their buttons when the choice alone sets it (ticket types, pack sizes).
Technical Implementation¶
The product catalog system is built on a document-based architecture using MongoDB, allowing for:
- Schema flexibility for different product types
- Fast query performance for catalog browsing
- Easy extension with new product attributes
The ProductService and related classes provide a comprehensive API for:
- Creating and updating products
- Searching and filtering the catalog
- Managing inventory levels
- Organizing products into collections
Integration Points¶
The product catalog integrates with: - Search System: For indexing and retrieval of product information - Order System: For inventory management and reservations - Content Management: For rich product descriptions and marketing material - Pricing System: For dynamic pricing and promotions
Administration¶
Products can be managed through: - Web-based admin interface - Bulk import/export functionality - API endpoints for integration with external systems
Upcoming Features¶
- Enhanced product recommendation engine
- AI-powered product naming and description generation
- Improved product variation management
- Advanced inventory forecasting