In-page search¶

In-Page Search is available as an optional query parameter ('q') on landing pages. This feature delivers the same robust search functionality as our standard search but with results specifically filtered to the current landing page context. Results are ranked using both our semantic match algorithm and the product lifecycle algorithm, aligning with the ranking logic of our standard search.

In-Page Search is particularly beneficial for specification-driven sites with large categories and numerous important keywords. It is especially useful in cases where the existing facets may be insufficient for narrowing down the search.

Guidelines for Implementing In-Page Search¶

To optimize user experience and distinguish In-Page Search from the site's main search, follow these best practices:

1. Enable Instant Search
   Implement dynamic updates to search results with each keystroke (instant search) to enhance user interaction and streamline the search process.

2. Clarify the Search Scope
   Clearly differentiate between the main site search and In-Page Search by communicating the scope each one covers. This ensures users understand where they are searching—either across the entire site or within a specific page category.

3. Visual Hierarchy and Layout
   Ensure the main site search is visually prominent, with adequate spacing between the two search bars. This helps prevent users from accidentally performing a scoped In-Page Search when they intended to search the entire site.

4. Use Supporting Text
   Provide helpful text for each search input field. For example:

   • Main search: "Search everything at Acme"
   • In-Page Search: "Search within category X"

5. Indicate Search Scope in Results
   Include the scope in the search result titles. For instance:

   • "Results in category X for 'search term'"

6. No-Hits View
   When no results are found, make it clear that the user performed a scoped search. Offer the option to re-run the query in the full main search scope with a single click.

7. Minimize Pinned Products or Slices
   Avoid pinned products or featured slices on pages with In-Page Search. This prevents confusion when the natural rank order is applied during search, making pinned items appear to disappear.

8. Hide In-Page Search When Results Are Limited
   Consider hiding the In-Page Search bar if the total number of products in the result is fewer than 20, as this may not provide enough value for a scoped search.