> For the complete documentation index, see [llms.txt](https://docs.lufavo.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.lufavo.com/roomfolk/pages/search-page.md).

# Search page

Where customers land after searching. It shows a search field, the results, and the same filtering and sorting as a collection page.

## Products

| Setting          | What it does |
| ---------------- | ------------ |
| Results per page | 8 to 48.     |

## Layout

| Setting            | What it does               |
| ------------------ | -------------------------- |
| Columns on desktop | 2 to 5.                    |
| Columns on mobile  | One column or two.         |
| Enable filtering   | Shows the filter controls. |
| Enable sorting     | Shows the sort menu.       |

As on the collection page, **which filters appear is set in Shopify's free Search & Discovery app**, not in the theme.

## Card

| Setting                    | What it does                                 |
| -------------------------- | -------------------------------------------- |
| Aspect ratio               | Natural, Square, Portrait or Landscape.      |
| Show vendor                | The product's vendor.                        |
| Show star rating           | Where a review app supplies one.             |
| Enable quick add           | An add to cart button on each card.          |
| Show second image on hover | Reveals the product's second image on hover. |

## Spacing and style

| Setting        | What it does                |
| -------------- | --------------------------- |
| Top spacing    | 0px to 120px.               |
| Bottom spacing | 0px to 120px.               |
| Color scheme   | Which scheme the page uses. |

## Suggestions as you type

Search suggests results as a customer types, from the header search box. It searches products, pages and blog posts, so someone looking for your delivery policy finds the page as readily as a product.

There is nothing to configure — it works from your store's own content.

## When nothing matches

The page says so plainly and keeps the search field in place, so the customer can try different words without going back.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.lufavo.com/roomfolk/pages/search-page.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
