# Quick Search

> Source: https://docs.recombee.com/recipes/e-commerce/search/quick-search

> For the complete documentation index, see [llms.txt](/llms.txt).

**Table of contents**

* [Introduction](#introduction)
* [Scenario Setup](#scenario-setup)
* [Logic](#logic)
* [Filters](#filters)
* [Requesting Search Results](#requesting-search-results)

# Quick Search

![](/img/recipes/e-commerce/quick-search.png) 

## Introduction

This use case enables your users to swiftly and effectively search for products that align with their preferences and activity on your platform. It ensures a seamless and efficient search experience tailored to their specific needs and text input.

## Scenario Setup

In the Recombee Admin UI, navigate to the **[Scenarios](/scenarios)** section and choose **Create Scenario**.

1. Enter a **Scenario ID**. Select a distinctive label for your recommendation scenario, such as _"search-products"_
2. Choose **Recommendation type** \- _[Search Items](/api#search-items)_

![Admin UI - Scenario Setup](/img/recipes/e-commerce/quick-search-create-scenario.png)

The Search Items endpoint performs a full-text search within the products. If you want to show matching categories or vendors besides the product, you can create additional scenarios of type [Search Item Segments](/api#search-item-segments).

## Logic

The [Logic](/recommendation_logics) defines the behavior of the recommendation engine.

* Choose the **[search:personalized](/recommendation_logics#search-personalized)** logic type from the **Universal Models**

You can adjust how much the results are biased towards the user (as opposed to strictly following the full-text results) by setting the `personalizationImpact` parameter.

![Admin UI - Logic](/img/recipes/e-commerce/quick-search-logic.png)

## Filters

Available Products (Global Settings)

You always want to recommend only the products that are in stock. Therefore you need to apply a [**Filter**](/scenarios#filters) rule to allow only such products.

As it would be tedious and prone to error to add this rule to all the Scenarios, this rule shall be added to the [**Global Settings**](/scenarios#scenarios-in-admin-ui-global-settings), so it is always applied everywhere.

You can select a **predefined rule from the Recombee Library** to allow only the available products.

Depending on how you represent availability in the catalog, it can be **one of the following rules:**

* **Not deleted items** \- when you have a _deleted_ property (true/false)
* **Available items** \- when you have an _available_ property (true/false)
* **Items in stock \[Google Merchant\]** \- when you have a string _available_ property with _"in stock"_ as its value

![Admin UI - Global Settings - Filter](/img/recipes/e-commerce/filter.png)

## Requesting Search Results

There are three ways to get search results.

1. **[No-Code Widget](/no-code-widgets)** \- create a [Quick Search No-Code Widget](/no-code-widgets#html-widget-full-text-search) using the **visual editor in the Admin UI**.
2. **[Widget SDKs](/widget-sdks)** \- use the Quick Search SDK for [vanilla JavaScript](/widget-sdks/quick-search-widget-js) or [React](/widget-sdks/quick-search-widget-react) to create a search widget with the design of your choice.
3. **[API SDK](/api_clients)** \- request the [Search Items endpoint](/api#search-items) of the Recombee API using an SDK of your choice.

For more information, navigate to the Integration tab of the Scenario in the Admin UI.

![Quick Search No-Code Widget](/img/gui/search-widget-sections.png)

Quick Search No-Code Widget