> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vulpy.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Storefront search in Vulpy Commerce

> The Starter Pack adds advanced storefront search on top of Vulpy Commerce, with facets and typo-tolerant queries served from the storefront app.

Vulpy Commerce ships with basic product listing on Core. The Starter Pack adds advanced storefront search with facets, better relevance, and typo tolerance. This page explains how search works and how to verify it is ready before going live.

<Tip>
  **Ask Fox to run the operation.** Reindexing, adding facets, and debugging misses are exactly what Fox is for.

  Try prompts like:

  * "Reindex products."
  * "Add a facet for material."
  * "Why is search returning no results for `padel racket`?"
</Tip>

## What you get on each edition

* **Core (free):** standard Medusa product listing on the storefront.
* **Starter Pack:** advanced search with facets, colour swatches, finish facets, and typo-tolerant queries.
* **Pro:** includes the Starter Pack, so advanced search is available by default.

For edition details, see [/reference/editions](/reference/editions).

## How search works

An indexer picks up products from Medusa and builds a searchable index. The storefront queries that index for the `/search` page and for category pages. Results include facets so shoppers can filter by colour, finish, and other attributes.

## Enable and verify search

Advanced search is enabled automatically when the Starter Pack is installed. To confirm it is working:

1. Start the storefront and index services in your environment.
2. Open `http://localhost:3000/search` in dev (or your live storefront domain).
3. Enter a query and confirm results render with facets.

If results do not appear, check that the index service is running and reachable from the storefront container.

## Facets and customization

Colour swatches and finish facets ship as Starter Pack facets. You can extend them further via Payload `productContent` metadata. For guidance on extending storefront blocks, see [/customize/blocks](/customize/blocks).

<Warning>
  Search requires the storefront to reach the index service (for example, Meilisearch or Algolia, as configured). Make sure the index service is running before you go live, or the search page will return no results.
</Warning>

<Note>
  For the underlying Medusa product query API, see the [Medusa docs](https://docs.medusajs.com/).
</Note>

<CardGroup cols={2}>
  <Card title="Catalog" href="/shop/catalog">
    Manage products, variants, and collections in Medusa and Payload.
  </Card>

  <Card title="Editions" href="/reference/editions">
    Compare Core, Starter Pack, Multi-Agent Pack, and Pro feature sets.
  </Card>
</CardGroup>