Pyle

Search ​

What This Is ​

Search is the storefront experience that helps shoppers find products by typing a query, narrowing by filters, and sorting the results they care about.

It is a shopper-facing search experience, not an admin search workspace.

When You Would Use It ​

Use Search when you want to:

  • find a product quickly from the storefront header
  • browse products from the dedicated search page
  • refine results by category, brand, collection, attributes, or price
  • sort the result list by price
  • narrow results to items that are actually available for your location

Before You Start ​

Make sure:

  • the storefront location is set correctly
  • the product you want is active and searchable
  • you know whether you want a broad search or a category/brand/collection browse

Search results can change based on your location, stock availability, and customer-specific restrictions.

How To Use It In The Storefront ​

  1. Type a product name or keyword into the storefront search field.
  2. Open the search page or the quick results dropdown.
  3. Use the available filters to narrow the list:
    • category
    • brand
    • collection
    • attributes
    • price range
  4. Use sorting if you want to change the order of results.
  5. If the result looks wrong, confirm your current location first.
  6. Open a product from the result list once you find the right match.

What It Changes In The Storefront ​

Search affects:

  • which products are shown first
  • which products are hidden because of your location
  • which products appear filtered out because of category, brand, collection, price, or stock conditions
  • which products remain visible after customer-specific restrictions are applied

Common Tasks ​

Find a product by name ​

Use the search field and then open the matching result.

Narrow a broad result set ​

Use filters like brand, category, collection, attributes, or price range.

Check whether a product is available for your location ​

If a product is missing, verify the location setting and try again.

Rules, Limits, And Things To Watch ​

  • Search results are based on active products.
  • Price filters and sort order can depend on the selected province or shipping location.
  • Some products are intentionally hidden or restricted for certain shoppers.
  • The quick search dropdown is not the same thing as the full search page, but both use the same search engine behavior.

Troubleshooting ​

Nothing appears ​

Check whether the search term is too narrow, whether the location is set, and whether the product is active.

Results change when location changes ​

That is expected. The search layer uses location-aware availability and pricing fields.

A product is visible in one place but not another ​

That can happen if the quick search, category browse, and full search are showing different views of the same underlying product catalog.

For a full storefront-visibility checklist, see How to troubleshoot why a product is missing from the storefront.

Sources ​

  • packages/framework/src/Actions/FastSearch/SearchProducts.php
  • packages/framework/src/Actions/Product/Requests/Storefront/SearchProducts.php
  • packages/storefront/src/Livewire/Storefront/Search/Page.php
  • packages/storefront/src/Livewire/Storefront/Navigation/SearchForm.php
  • packages/storefront/src/Livewire/Storefront/FastSearch/Wrapper.php
  • packages/storefront/src/Livewire/Storefront/FastSearch/Hits.php
  • packages/storefront/src/Livewire/Storefront/FastSearch/SearchBar.php
  • packages/storefront/src/Livewire/Storefront/FastSearch/FiltersBar.php
  • packages/storefront/src/Livewire/Storefront/FastSearch/FiltersDrawer.php
  • packages/storefront/src/Livewire/Storefront/FastSearch/FilterByPrice.php
  • packages/storefront/src/Livewire/Storefront/FastSearch/FilterByFacetFilterList.php