Shopping assistant

Shopping Assistant is an interactive tool that helps customers find products through a guided question flow instead of a traditional filter-first experience. Each answer narrows the catalog, updates the visible hits, and moves the shopper toward a smaller, more relevant set of products.

Start here

Planning the integration? Start with Shopping Assistant implementation flow.

Building the experience now? Start with Building a custom shopping assistant.

Need the request and response schema? Continue with the Assistant API overview and the endpoint reference.

Need analytics for learning and measurement? Review Shopping Assistant analytics before launch.

Guides

Implementation flow

Plan the request loop, state model, rendering contract, and edge cases before building the UI.

Analytics

Understand what the assistant tracks automatically and which product outcome events your integration still needs to send.

Quickstart

Build a custom shopping assistant

Make the first request, render questions and products, manage steps, and add downstream product tracking.

Core concepts

• Guided discovery: Your application stores the conversation state and sends it back as steps on every request.
• Live result narrowing: Every answer updates both the currently matching products and the next question.
• Runtime field selection: Use field_overrides when the active price or availability field is known only at request time.
• Learning from analytics: The assistant can learn from user interactions once Luigi’s Box analytics is integrated and downstream product actions are tracked.

Use cases

• Complex products — Help customers navigate technical specifications
• Gift recommendations — Guide gift buyers to the perfect present
• Style matching — Match fashion/home decor items to customer preferences
• Bundle building — Assist in creating product combinations
• Need-based discovery — Find products based on use case rather than category