> 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/sections/featured-collection.md).

# Featured collection

A row of products from one collection — new arrivals, best sellers, whatever you want in front of people.

## Set it up

1. Add the section.
2. Choose a **Collection**.
3. Set how many products to show and how many columns.

## Products

| Setting            | What it does                                                                                 |
| ------------------ | -------------------------------------------------------------------------------------------- |
| Collection         | The collection to show products from.                                                        |
| Products           | Used only when no collection is chosen. Pick individual products from anywhere in the store. |
| Products to show   | 2 to 12.                                                                                     |
| Show view all link | A link through to the full collection.                                                       |
| Link               | Where "view all" goes. Leave empty to link to the chosen collection.                         |

**Two ways to fill it.** Pick a collection and it shows the first products in that collection, in the collection's own order. Or leave the collection empty and hand-pick products instead. The collection wins if you set both.

**Hand-picking is a fixed list.** It will not change as your catalog does, so it suits a curated row rather than "new arrivals".

## Card

| Setting                    | What it does                                               |
| -------------------------- | ---------------------------------------------------------- |
| Aspect ratio               | Natural, Square, Portrait or Landscape.                    |
| Show vendor                | The product's vendor above its name.                       |
| Show star rating           | The product's review rating.                               |
| Enable quick add           | An add to cart button on the card.                         |
| Show second image on hover | Reveals the product's second image when a customer hovers. |

**On Natural aspect ratio:** every card keeps its own image shape. This looks best when your photography is consistently shaped and worst when it is not — a tall image beside a wide one makes an uneven row. Choose one of the fixed shapes if your images vary.

**On star ratings:** these only appear where a review app has supplied one. If you do not use a review app, nothing shows, whatever this is set to.

**On quick add:** a product gets an add to cart button only when it has a single variant and is not sold on subscription. Anything else gets a "Choose options" link through to the product page instead — a product with options, because adding it straight to the cart would mean guessing which one the customer wanted, and a subscription product, because Shopify rejects an add that carries no delivery plan.

**On hover images:** products with only one image are unaffected.

## Content, layout, spacing and style

| Setting            | What it does                   |
| ------------------ | ------------------------------ |
| Kicker             | Small line above the heading.  |
| Heading            | The section heading.           |
| Heading size       | Small, Medium or Large.        |
| Description        | A sentence under the heading.  |
| Columns on desktop | 2 to 5.                        |
| Columns on mobile  | One column or two.             |
| Top spacing        | 0px to 120px.                  |
| Bottom spacing     | 0px to 120px.                  |
| Color scheme       | Which scheme the section uses. |


---

# 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/sections/featured-collection.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.