Search quickstarts

Search can be integrated through Search.js for a fast storefront implementation or through the Search API when you want complete control over the rendering layer. These guides help you choose the path first, then deepen the integration.

Choose your path

Recommended for web

Search.js

Use Luigi's Box's frontend library when you want a full search page with filters, sorting, and analytics out of the box.

• Fastest path for storefront teams.
• Built-in filtering, pagination, and campaigns.
• Automatic analytics reporting.

Custom build

Search API

Use the API when you need server-side control, custom rendering, SEO-sensitive pages, or a mobile/backend integration.

• Complete control over UI and payloads.
• Fits backend-rendered search pages well.
• Lets you combine Luigi's Box data with internal business logic.

Quickstart collection

General

Understand the system first

These guides explain how search works before you commit to one implementation style.

Choose your integration path

Review the main search features and decide between Search.js and the Search API.

Understand ranking

See which catalog and behavioral signals influence the order of results.

Search.js

Frontend library path

Choose this when you want the fastest web implementation.

Integrate Search.js

Launch a complete search page with Luigi's Box handling the heavy lifting.

Customize Search.js

Override templates to fit the visual language of your storefront.

Search API

Custom implementation path

Use these guides when you own the rendering layer.

Build a custom search UI

Render results, filters, and pagination from raw API responses.

Render banner campaigns

Extend your custom search page with campaign payloads from the API.

Implement variant search

Choose how product variants should be indexed and displayed in results.