Manual selection
The user chooses an exact retailer product, quantity, cadence, price ceiling, and substitution policy.
Module 05
A product catalog built around household intent.
Preferred Products separates what the household wants from what the retailer currently offers. Exact product references are preserved, and every alternative is explicit or reviewed.
4preference sources
5resolution stages
3substitution policies
1exact ID first
Model
From sources to resolved cart item
Sources
Four ways a product enters the catalog
Past Purchases
Import a bounded history period and suggest recurring cadence while preserving exact retailer product references.
Saved lists
Read a selected Stop & Shop list and let the user choose which entries become recurring preferences.
Agent suggestion
Propose a product based on sanitized behavior features; it remains inactive until the user confirms it.
Resolution ladder
Prefer certainty over cleverness
- 01
Exact active retailer reference
Validate that the known SKU still exists, is available, matches size, and has a fresh price.
- 02
User-approved alternative
Check the ordered alternative list and enforce the same size and price limits.
- 03
Deterministic candidate search
Filter by retailer category, brand policy, size range, unit, availability, and price.
- 04
Optional model ranking
Rank only the small sanitized candidate set; do not let the model invent a product ID.
- 05
Rules and review
Validate the selected candidate. Insufficient confidence becomes user review or skip.
Preference shape