Product Discovery Quick Start

The Product Discovery drop-in powers search and category browsing with AI-enhanced results, faceted filtering, sorting options, and customizable product listings.

Version: 2.1.0

Quick example

The Product Discovery drop-in is included in the Commerce boilerplate . This example shows the basic pattern:

// 1. Import initializer (handles all setup)
import '../../scripts/initializers/search.js';

// 2. Import the container you need
import Facets from '@dropins/storefront-product-discovery/containers/Facets.js';

// 3. Import the provider
import { render as provider } from '@dropins/storefront-product-discovery/render.js';

// 4. Render in your block
export default async function decorate(block) {
  await provider.render(Facets, {
    // Configuration options - see Containers page
  })(block);
}

New to drop-ins? See the Using drop-ins guide for complete step-by-step instructions.

Quick reference

Import paths:

• Initializer: import '../../scripts/initializers/search.js'
• Containers: import ContainerName from '@dropins/storefront-product-discovery/containers/ContainerName.js'
• Provider: import { render } from '@dropins/storefront-product-discovery/render.js'

Package: @dropins/storefront-product-discovery

Version: 2.1.0 (verify compatibility with your Commerce instance)

Example container: Facets

Learn more

• Containers - Available UI components and configuration options
• Initialization - Customize initializer settings and data models
• Functions - Control drop-in behavior programmatically
• Events - Listen to and respond to drop-in state changes
• Slots - Extend containers with custom content