> 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/blocks/product-blocks.md).

# Product blocks

The product page is built from blocks, so you decide what appears beside the product images and in what order. Add, remove and drag them in the theme editor with the product page open.

They are also available in the [Featured product](/roomfolk/sections/featured-product.md) section.

## Product heading

The product's name. No settings — it comes from the product itself.

This is the page's Heading 1, so keep it on the page.

## Price

| Setting                    | What it does                                                    |
| -------------------------- | --------------------------------------------------------------- |
| Show tax and shipping note | A line reading "Tax excluded. Shipping calculated at checkout." |

The price updates on its own when a customer picks a different variant. Sale prices show the original struck through beside the new one, and unit prices appear where a product has them.

**On the tax note:** the wording follows your store's tax settings, so it reads correctly whether your prices include tax or not.

## Vendor

| Setting                   | What it does                                            |
| ------------------------- | ------------------------------------------------------- |
| Link to vendor collection | Makes the vendor name a link to that vendor's products. |

Only shows for products that have a vendor set.

## Variant picker

The product's options — size, color and so on. No settings.

Options with color or image swatches set up in your Shopify admin show as swatches. Everything else shows as labelled buttons. Combinations that are not available are marked, and the add to cart button turns into "Sold out" when the chosen combination cannot be bought.

## Buy buttons

| Setting                | What it does                    |
| ---------------------- | ------------------------------- |
| Show quantity selector | Lets customers choose how many. |

This block also carries:

* **Add to cart**, which adds without leaving the page and opens the cart drawer.
* **Accelerated checkout** — Shop Pay and the other express buttons — where your store has them enabled.
* **Shop Pay Installments**, where the store and the price qualify.
* **Gift card recipient fields**, on gift card products, so a customer can send one to someone else with a message and a delivery date.

You cannot restyle the express buttons. Shopify requires their branding to be left as it is, and the theme leaves it alone.

## Description

| Setting                    | What it does                                          |
| -------------------------- | ----------------------------------------------------- |
| Collapse long descriptions | Shows the first few lines with a "Read more" control. |
| Lines to show              | 2 to 20.                                              |

**Why collapsing helps:** a long description pushes the price and the add to cart button down the page, sometimes off the screen entirely. Collapsing keeps the buying controls in view.

The Read more control only appears when there is more text than fits, so short descriptions are unaffected.

## Collapsible row

| Setting | What it does       |
| ------- | ------------------ |
| Heading | The row's label.   |
| Content | What is inside it. |

Add one per topic — shipping, returns, materials and care. Add as many as you need.

Use these for information that is the same across products. Anything specific to one product belongs in its description.

## Pickup availability

Shows whether the selected variant can be collected from one of your locations. No settings.

**It shows nothing unless you have pickup enabled** on at least one location in **Settings → Locations**. Merchants who do not offer collection never see an empty panel.

## Purchase options

Subscription and selling plan options, for products that have them. No settings.

Only appears on products with a selling plan attached.


---

# 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/blocks/product-blocks.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.