Skip to content
Adobe Commerce Storefront

Search is only available in production builds. Try building and previewing the site to test it out locally.

Product Discovery overview

The Product Discovery drop-in enables you to display and customize product search results, category listings, and faceted navigation within your storefront.

The Product Discovery drop-in component provides a set of modular, event-driven containers—such as product lists, facets, sort controls, and pagination—that can be used individually or composed together to build tailored product listing pages (PLPs), category pages, and quick search experiences.

Each container reacts to search events orchestrated by the search API functions, ensuring the UI stays in sync as shoppers search, filter, sort, and paginate through results. Multiple search instances can run on the same page using scoped contexts, allowing for features like a full-page PLP and a quick search overlay.

Data Flows

Loading diagram...
Event Driven Architecture — Search

Scoped Quick Search Flow (pop-over)

Loading diagram...
Event Driven Architecture — Quick Search

Core Design Principles

  • Event-Driven: Container communication via a central event bus
  • Modular: UI is split into purpose-specific containers
  • Scoped: Supports multiple isolated search instances with full ACDL compliance

Key capabilities

  • Composable. Use SearchResults, Facets, Pagination, and SortBy containers to build your desired layout.
  • Scoped search contexts to support multiple independent search areas on a single page (for example, PLP and quick search).
  • Slot-based customization – Extend or replace UI parts, such as headers, footers, or product action areas.
  • Pre-selected filters, sort order, and pagination are automatically sync with the current search state.
  • Pre-integrated data collection events compatible with ACDL for each stage of the search lifecycle.

Use cases

  • Product listing pages (PLPs) – Display results by filtering, sorting, and paginating.
  • Category pages – Show products and refinements scoped to a specific category.
  • Quick search overlays to provide instant results as shoppers type.

Supported Commerce features

The following table provides an overview of the Adobe Commerce features that the Product Discovery drop-in component supports:

FeatureStatus
Simple Product ViewSupported
Complex Product ViewSupported