sf-catalog
Before Writing Code
Fetch live docs before implementing catalog features.
- Web-search: "Salesforce B2C Commerce Cloud catalog management documentation 2026"
- Web-search: "Salesforce B2B Commerce Product2 ProductCatalog documentation 2026"
- Web-search: "Salesforce B2C Commerce price books promotions documentation 2026"
- Web-search: "Salesforce B2B Commerce buyer groups entitlements 2026"
- Web-fetch the SFCC Business Manager catalog structure reference
- Web-fetch the Salesforce Product2 and Pricebook2 object reference
Conceptual Architecture
B2C Commerce Catalog Model
Master Catalog (shared across sites)
-> Site Catalog (site-specific subset)
-> Categories (hierarchical tree)
-> Products (assigned to categories)
Catalog Hierarchy:
- Master Catalog: Contains all products, shared across multiple sites
- Site Catalog: Site-specific subset; inherits products from master
- Categories: Hierarchical navigation tree; products have one primary category, multiple secondary
- Catalog Assignment: Products linked to catalogs via catalog-product relationships
Product Type Taxonomy:
| Product Type |
Description |
| Standard Product |
Simple product without variations |
| Master Product |
Parent defining shared attributes |
| Variation Group |
Optional grouping layer between master and variations |
| Variation Product |
Specific SKU with unique variation attributes (color, size) |
| Product Set |
Curated collection (e.g., "Complete the Look") |
| Product Bundle |
Package of products sold together at bundle price |
Attribute System:
- Products carry standard attributes (name, description, price, images) and custom attributes
- Searchable attributes are indexed for full-text search and faceted navigation
- Variation attributes (color, size) define the master-to-variation relationship
- Custom attributes defined in Business Manager or via XML import
Pricebook Hierarchy:
| Concept |
Detail |
| Price Book |
Container for prices; supports multiple currencies |
| List Price |
Base price (MSRP) |
| Sale Price |
Promotional price, time-bound |
| Customer Group Pricing |
Segment-specific prices |
| Price Book Inheritance |
Child books inherit from parent; override selectively |
| Price Tiers |
Quantity-based pricing rules |
Promotions Engine:
- Product promotions (discount on specific products/categories)
- Order promotions (cart-level, e.g., $10 off $50)
- Shipping promotions (free/discounted shipping)
- Qualifiers: cart total, product quantity, customer group
- Exclusivity rules control stacking; coupon codes single-use or multi-use
Search and Refinements:
- Proprietary search index managed by Salesforce
- Searchable attributes indexed for faceted navigation
- Sorting rules: relevance, price, newest, custom
- Search suggestions (typeahead), did-you-mean, search redirects
Import/Export:
- Bulk XML import via Business Manager or jobs; strict XSD schema
- Delta import for incremental updates (performance optimization)
- Import modes: replace, update, or delete existing data
B2B Commerce Catalog Model
ProductCatalog (B2B container)
-> ProductCategory (categories)
-> Product2 (standard Salesforce object)
-> PricebookEntry (price per pricebook)
-> Buyer Group Entitlements
B2C vs B2B Catalog Comparison:
| Aspect |
B2C (SFCC) |
B2B (Lightning) |
| Product object |
SFCC Product (proprietary) |
Product2 (standard sObject) |
| Category object |
SFCC Category |
ProductCategory (B2B-specific) |
| Price container |
Price Book (SFCC) |
Pricebook2 (standard sObject) |
| Price entry |
Price per book + currency |
PricebookEntry (junction object) |
| Visibility control |
Site catalog assignment |
Buyer Group Entitlements |
| Variant model |
Master -> Variation Products |
Product2 child records + custom fields |
| Search |
Proprietary SFCC index |
Commerce Search (Einstein-powered) |
| Import |
XML via Business Manager |
Batch Apex, Platform Events, Data Loader |
Entitlements and Visibility (B2B):
- Buyer Groups: collections of buyer accounts (WebStore BuyerGroup)
- Product Entitlements: control which buyer groups see which products
- Price Entitlements: control which buyer groups see which prices
- Account hierarchies: parent-child visibility inheritance
Volume Pricing (B2B):
- Tiered pricing with quantity breaks at different unit prices
- Negotiated pricing via account-specific custom price books
- Contract pricing for long-term agreements per account
- Consider Salesforce CPQ for complex pricing logic
Content Integration (B2C)
- Content Library: Shared content assets (text, HTML, images)
- Content Slots: Dynamic placeholders on category and product pages
- Page Designer: Visual page builder for merchandising pages
Catalog Sync (B2B)
- ERP integration: sync products from SAP, Oracle, or other systems
- Scheduled batch Apex or Platform Events for bulk updates
- Change Data Capture (CDC) for real-time product updates
- Custom Metadata for catalog configuration without custom objects
Code Examples
// Pattern: B2C product retrieval
// Fetch live docs for SCAPI Shopper Products API
// GET /products/{id} -> product attributes, pricing, variants
// Pattern: B2B product query with entitlements
// Fetch live docs for Product2, BuyerGroup, and Entitlement objects
// Query Product2 WHERE entitled for buyer group
Best Practices
B2C Catalog Structure
- Keep master catalog clean; use site catalogs for site-specific products
- Limit category depth to 3-4 levels for performance and UX
- Plan variation attributes upfront (color, size) for consistency
- Use delta imports for incremental updates; validate XML against XSD before import
B2C Pricing and Promotions
- Use price book inheritance to avoid duplicate pricing data
- Set list price and sale price separately (never overwrite list)
- Test promotion stacking rules before launch to prevent unintended discounts
- Schedule promotions to auto-start/end (avoid manual changes)
B2B Catalog Management
- Use standard Product2 fields where possible; avoid over-customization
- Create buyer-group-specific price books; use standard book as fallback
- Document entitlement rules clearly (who sees what)
- Use batch Apex or Platform Events for large catalog syncs from ERP
Cross-Platform
- Maintain single source of truth for product master data (PIM or ERP)
- Rebuild search indexes after major catalog changes
- Test catalog changes in sandbox before production
- Use SCAPI (not OCAPI) for new B2C implementations
Fetch the SCAPI Shopper Products reference and Salesforce Product2 object docs for exact field names and schemas before implementing.
1---2name: sf-catalog3description: Manage Salesforce Commerce catalogs — B2C (Business Manager catalogs, categories, products, pricing books, promotions, search indexes) and B2B (Product2, Pricebook2, PricebookEntry, volume discounts, entitlements). Use when working with product data across either platform.4allowed-tools: Read, Write, Edit, Bash, Grep, Glob, WebSearch, WebFetch5metadata:6 source: https://skillmd.com/skills/orcaqubits/sf-catalog7---89# sf-catalog1011## Before Writing Code1213**Fetch live docs before implementing catalog features.**14151. Web-search: "Salesforce B2C Commerce Cloud catalog management documentation 2026"162. Web-search: "Salesforce B2B Commerce Product2 ProductCatalog documentation 2026"173. Web-search: "Salesforce B2C Commerce price books promotions documentation 2026"184. Web-search: "Salesforce B2B Commerce buyer groups entitlements 2026"195. Web-fetch the SFCC Business Manager catalog structure reference206. Web-fetch the Salesforce Product2 and Pricebook2 object reference2122## Conceptual Architecture2324### B2C Commerce Catalog Model2526```27Master Catalog (shared across sites)28 -> Site Catalog (site-specific subset)29 -> Categories (hierarchical tree)30 -> Products (assigned to categories)31```3233**Catalog Hierarchy:**34- **Master Catalog**: Contains all products, shared across multiple sites35- **Site Catalog**: Site-specific subset; inherits products from master36- **Categories**: Hierarchical navigation tree; products have one primary category, multiple secondary37- **Catalog Assignment**: Products linked to catalogs via catalog-product relationships3839**Product Type Taxonomy:**4041| Product Type | Description |42|---|---|43| Standard Product | Simple product without variations |44| Master Product | Parent defining shared attributes |45| Variation Group | Optional grouping layer between master and variations |46| Variation Product | Specific SKU with unique variation attributes (color, size) |47| Product Set | Curated collection (e.g., "Complete the Look") |48| Product Bundle | Package of products sold together at bundle price |4950**Attribute System:**51- Products carry standard attributes (name, description, price, images) and custom attributes52- Searchable attributes are indexed for full-text search and faceted navigation53- Variation attributes (color, size) define the master-to-variation relationship54- Custom attributes defined in Business Manager or via XML import5556**Pricebook Hierarchy:**5758| Concept | Detail |59|---|---|60| Price Book | Container for prices; supports multiple currencies |61| List Price | Base price (MSRP) |62| Sale Price | Promotional price, time-bound |63| Customer Group Pricing | Segment-specific prices |64| Price Book Inheritance | Child books inherit from parent; override selectively |65| Price Tiers | Quantity-based pricing rules |6667**Promotions Engine:**68- Product promotions (discount on specific products/categories)69- Order promotions (cart-level, e.g., $10 off $50)70- Shipping promotions (free/discounted shipping)71- Qualifiers: cart total, product quantity, customer group72- Exclusivity rules control stacking; coupon codes single-use or multi-use7374**Search and Refinements:**75- Proprietary search index managed by Salesforce76- Searchable attributes indexed for faceted navigation77- Sorting rules: relevance, price, newest, custom78- Search suggestions (typeahead), did-you-mean, search redirects7980**Import/Export:**81- Bulk XML import via Business Manager or jobs; strict XSD schema82- Delta import for incremental updates (performance optimization)83- Import modes: replace, update, or delete existing data8485### B2B Commerce Catalog Model8687```88ProductCatalog (B2B container)89 -> ProductCategory (categories)90 -> Product2 (standard Salesforce object)91 -> PricebookEntry (price per pricebook)92 -> Buyer Group Entitlements93```9495**B2C vs B2B Catalog Comparison:**9697| Aspect | B2C (SFCC) | B2B (Lightning) |98|---|---|---|99| Product object | SFCC Product (proprietary) | Product2 (standard sObject) |100| Category object | SFCC Category | ProductCategory (B2B-specific) |101| Price container | Price Book (SFCC) | Pricebook2 (standard sObject) |102| Price entry | Price per book + currency | PricebookEntry (junction object) |103| Visibility control | Site catalog assignment | Buyer Group Entitlements |104| Variant model | Master -> Variation Products | Product2 child records + custom fields |105| Search | Proprietary SFCC index | Commerce Search (Einstein-powered) |106| Import | XML via Business Manager | Batch Apex, Platform Events, Data Loader |107108**Entitlements and Visibility (B2B):**109- Buyer Groups: collections of buyer accounts (WebStore BuyerGroup)110- Product Entitlements: control which buyer groups see which products111- Price Entitlements: control which buyer groups see which prices112- Account hierarchies: parent-child visibility inheritance113114**Volume Pricing (B2B):**115- Tiered pricing with quantity breaks at different unit prices116- Negotiated pricing via account-specific custom price books117- Contract pricing for long-term agreements per account118- Consider Salesforce CPQ for complex pricing logic119120### Content Integration (B2C)121122- **Content Library**: Shared content assets (text, HTML, images)123- **Content Slots**: Dynamic placeholders on category and product pages124- **Page Designer**: Visual page builder for merchandising pages125126### Catalog Sync (B2B)127128- ERP integration: sync products from SAP, Oracle, or other systems129- Scheduled batch Apex or Platform Events for bulk updates130- Change Data Capture (CDC) for real-time product updates131- Custom Metadata for catalog configuration without custom objects132133## Code Examples134135```javascript136// Pattern: B2C product retrieval137// Fetch live docs for SCAPI Shopper Products API138// GET /products/{id} -> product attributes, pricing, variants139```140141```apex142// Pattern: B2B product query with entitlements143// Fetch live docs for Product2, BuyerGroup, and Entitlement objects144// Query Product2 WHERE entitled for buyer group145```146147## Best Practices148149### B2C Catalog Structure150- Keep master catalog clean; use site catalogs for site-specific products151- Limit category depth to 3-4 levels for performance and UX152- Plan variation attributes upfront (color, size) for consistency153- Use delta imports for incremental updates; validate XML against XSD before import154155### B2C Pricing and Promotions156- Use price book inheritance to avoid duplicate pricing data157- Set list price and sale price separately (never overwrite list)158- Test promotion stacking rules before launch to prevent unintended discounts159- Schedule promotions to auto-start/end (avoid manual changes)160161### B2B Catalog Management162- Use standard Product2 fields where possible; avoid over-customization163- Create buyer-group-specific price books; use standard book as fallback164- Document entitlement rules clearly (who sees what)165- Use batch Apex or Platform Events for large catalog syncs from ERP166167### Cross-Platform168- Maintain single source of truth for product master data (PIM or ERP)169- Rebuild search indexes after major catalog changes170- Test catalog changes in sandbox before production171- Use SCAPI (not OCAPI) for new B2C implementations172173Fetch the SCAPI Shopper Products reference and Salesforce Product2 object docs for exact field names and schemas before implementing.