# Brew guide

Chapter 10 of the Roast user guide.

The **Brew guide** section is your recipe card: method tabs along the top, then the selected recipe with its dose, water, ratio, temperature and brew time, a grind scale, a cups stepper, and a timer that walks the shopper through each step. It needs no metafields; every recipe lives in the section. Add it to the home page, a "Brew guides" page or a blog article's template.

## Section settings

| Setting | Default | What it does |
| --- | --- | --- |
| Kicker, Heading, Text | Brew guides; Brew it like we do; a short lede | The copy above the tabs |
| Link label, Link | All brew guides | A link beside the heading, such as to your brewing blog. Hidden without a link. |
| Temperature unit | Celsius | Or Fahrenheit. It changes the unit shown; write each method's temperature in the unit you choose. |
| Most cups | 4 (1 to 6) | The top of the cups stepper. 1 hides the stepper. |
| Show the timer | On | Off shows the steps as a plain list. |
| Background | Page | Page, Kraft or a label color |

## Brew method blocks

Add one **Brew method** block per brewer, up to eight. The section starts with six: Pour over (15 g, 250 g, 94°, 3:00, grind 3), AeroPress (15 g, 220 g, 88°, 2:00, grind 2), Plunger (30 g, 500 g, 94°, 4:00, grind 5), Espresso (18 g, 36 g, ratio 1:2, 93°, 0:28, grind 1), Stovetop (17 g, 200 g, 5:00, grind 2) and Cold brew (100 g, 1000 g, 12 h, grind 6).

| Setting | Default | What it does |
| --- | --- | --- |
| Icon | Pour over | The tab pictogram: Pour over, AeroPress, Plunger, Espresso, Stovetop, Cold brew, Teapot, Gaiwan or Hot chocolate |
| Name | Pour over | The tab name |
| Dose label, Dose (g) | Coffee, 15 | "Tea" or "Chocolate" for other shops |
| Water label, Water (g) | Water, 250 | "Milk" for hot chocolate |
| Ratio | Empty | Leave blank to work it out (250 ÷ 15 = 1:16.7), or write your own, such as 1:2 |
| Water temperature | Empty | Leave blank to hide it (stovetop, cold brew) |
| Brew time | 3:00 | Minutes and seconds run the timer. Anything else, such as 12 h, is shown without a timer. |
| Grind | 3 (0 to 7) | The grind scale: 1 extra fine, 7 extra coarse, 0 hides it. Names and comparisons come from Theme settings › Tasting and roast. |
| Steps | Five pour-over steps | One step per line, starting with its time |
| Note | Empty | A rich-text tip under the recipe |

## Writing steps

Write each step on its own line, starting with the time it begins:

```
0:00 Rinse the paper, add 15 g of coffee and pour 45 g of water to bloom.
0:45 Pour slowly in circles to 150 g.
1:15 Pour to 250 g, keeping the bed level.
1:45 Give the brewer a gentle swirl and let it drain.
3:00 Done. Pour, wait a minute, then taste.
```

* A line without a time at the start shows as an untimed note in the list.
* Amounts written as a number followed by `g` or `ml` ("45 g", "150ml") scale with the cups stepper, along with the dose and water. Ratios and times stay as written; one cup restores your numbers.
* While the timer runs, the current step is highlighted and finished steps fade. Screen readers hear each new step once. The timer keeps the right time if the shopper switches tabs, and switching method resets it. It makes no sound.
* A method without steps hides the steps and the timer.

With no Brew method blocks, the section is hidden from shoppers; the editor shows a sample pour-over recipe with a note. Without script, the page shows the first recipe for one cup.

## How to brew it, on the product page

The **How to brew it** block puts a product's brew methods (`custom.brew_methods`, as "Best for" chips with pictograms) and its recommended grind (`custom.recommended_grind`, "Medium-fine, like fine sea salt") in the buy box, with a link to your brew guide. Without a recommended grind it uses the grind the shopper has selected, through **Grind levels**.

| Setting | Default | What it does |
| --- | --- | --- |
| Heading | How to brew it | |
| Style | Collapsible row | Or **Card**, an open card |
| Link label, Link | Open the brew guide | Point it at the page with your Brew guide section |
| Product | Empty | For using the block outside a product page, such as in a blog article |

## The grind picker

A variant option named like **Theme settings › Tasting and roast › Grind option name** (Grind) shows as the grind picker: tiles with a particle glyph that grows from fine to coarse. The glyph size comes from **Grind levels**, a list of `Option value: level` pairs (`Whole bean: 0, Espresso: 1, Stovetop: 2, AeroPress: 2, Pour over: 3, Filter: 3, Plunger: 5, Cold brew: 6`); name your option values the same way. Set **Grind help page** to add a "Which grind?" link beside it.