Product Catalog & Recommendations
Product recommendations need a catalog. AXO builds one for you from whichever sources you have – then serves AI-ranked product cards through product_reco zones. Review everything it knows on the Catalog page.
Getting products in
- Shopify sync (zero effort). Link your store from the Shopify App Store install flow; products sync automatically through the store connection – no upload needed.
- On-page scraper (automatic). The tag detects products on the pages visitors actually browse – via JSON-LD structured data, Open Graph meta tags, or DOM heuristics – and submits them at idle priority, throttled per URL. This keeps the catalog fresh with live names, prices, images, and availability even without any integration.
- CSV / JSON import. Push your feed to
POST /api/catalog/importwith your site API key. Onlynameis required; price, category, URL, SKU, image, brand, description, availability, and ratings are all supported.
When sources overlap, the freshest wins: Shopify data takes precedence, then live scraped data, then imports, then AI inferences from the site crawl.
The Catalog page
Three views: Products (every unique product merged across sources, with image, price, category, availability, rating, and SKU), Categories (auto-extracted category groupings with product and page counts – products can be reclassified if the AI filed one wrong), and Pages (your pages grouped by type, each with its extracted product list and a semantic summary).
Recommendation zones
A product_reco variant renders a product card rail inside any zone. Three authoring modes:
Curated
You hand-pick the exact products and their order. No engine ranking – what you pin is what renders.
Auto-rank
The engine picks; you set the strategy – session_behavior (based on what this visitor browsed), bestsellers, new_arrivals, or similar (to the viewed item) – and the scope (full catalog, or restricted to one category). If a strategy has no data for a visitor (e.g. a fresh session), it degrades gracefully to bestsellers.
Mixed
Pin a few products to stable slots; the engine auto-ranks the rest up to your max. Best of both when merchandising rules meet personalization.
Each card is capped at a configurable max (up to 20 products) with a fallback behavior when nothing qualifies. On sites with semantic ranking enabled, products are also embedded and tagged with vibe codes – semantic descriptors the engine matches against the session's dominant vibe.
Preview before you publish
Use Preview as to see the live ranking for a fresh visitor, a random sample from a segment, or a specific session. The preview shows each recommended product with the engine's reason for choosing it, the strategy actually used (including any degradation), and the decision latency – so you know exactly what a real visitor in that state would see.