Autocomplete

Luigi’s Box Autocomplete is a feature designed to show customers relevant, real-time results from their very first keystroke. The system is highly optimized for speed (latency), providing an instant and seamless user experience. It learns from user behavior through analytics integration to continuously improve the relevance of its suggestions.

To accommodate different development needs, Autocomplete can be integrated in two primary ways. You can use Autocomplete.js, a comprehensive JavaScript widget that handles all functionality out of the box, or the core Autocomplete API for a fully custom implementation.

Choose your integration path

Recommended for web

Autocomplete.js

A JavaScript widget that combines autocomplete, top items, trending queries, and analytics into one frontend integration.

• Fastest implementation path.
• Built-in layouts and storefront-friendly defaults.
• Automatic analytics handling.

Custom build

Autocomplete API

Use the APIs directly when you need a custom UI, a backend-managed flow, or a mobile integration.

• Full control over rendering and behavior.
• Supports richer filtering and personalization.
• Lets you add features incrementally.

Start here

Still comparing paths? Start with features and integration strategies.

Fastest storefront implementation? Continue with Implementing Autocomplete.js.

Need a custom interface? Continue with Getting query suggestions via the API.

Core concepts

Beyond the primary integration paths, Autocomplete is enhanced by several key APIs and concepts that create a complete experience.

• Trending queries API: This API fetches the most popular and relevant search queries based on your site’s analytics. These phrases can be used as placeholders in the search bar or to provide typing suggestions to guide users.
• Top items API: Use this API to populate a recommender popup with your most popular items. It’s designed to engage users the moment they click into the search box, even before they start typing anything.
• Performance: The Autocomplete feature is engineered for speed. To achieve low latency, it fetches only the top results (top-k hits) rather than scanning the entire index, which means it does not provide a total hits count.