Build a repeatable home espresso workflow and shot record
Set up a home espresso workflow and shot record that captures your equipment, preparation sequence, single-dose weights, beverage yield and timing so you can revisit any recipe.
Contents
- The short answer
- Why dose, yield and time belong together
- Step 1: Identify the setup the record applies to
- Step 2: Write your preparation sequence as numbered steps
- Step 3: Record single-dose weights at two points
- Step 4: Log each shot
- Step 5: Version the record and keep changes separate
- What to take from forum workflows
The short answer
A repeatable home espresso workflow has two parts: a fixed preparation sequence you follow every time, and a shot record that captures the measured inputs and outputs of each shot. Together they let you return to a shot you liked, or work out what changed when a shot goes wrong. The record should identify your equipment and coffee, list your preparation steps in order, and log at least the dose, grinder setting, beverage yield and shot time. If you single dose, it should also log both the weight of the beans you put into the grinder and the weight of the grounds that actually reached the basket.
This guide covers how to structure that record. It is not a recipe or a dial-in method, and the numbers in it are examples, not targets for your machine.
Why dose, yield and time belong together
Most home espresso recipes are written as three linked numbers: the dry coffee dose, the weight of liquid espresso in the cup (the yield), and the time the shot takes. Birma Coffee's home espresso guide, for example, uses 18 g of coffee producing roughly 36 g of beverage in 25 to 30 seconds. That works out to about a 1:2 ratio of dry coffee to beverage. Treat it as one published recipe example rather than a requirement for every machine, basket or coffee.
Recording all three numbers matters because each one only makes sense in relation to the others. Coffeedant's dosing guide recommends pairing the dry dose with the beverage output instead of tracking the dose on its own. A dose with no yield next to it can't tell you whether the shot ran at the ratio you intended.
Step 1: Identify the setup the record applies to
Start each record, or each new page of a shot journal, by naming what the numbers depend on. A dose and grind setting that work on one setup may not carry over to another.
- Machine model and revision
- Grinder model
- Basket, including any size marking printed on it
- Coffee: roaster, name and roast date if you track it
- Recipe version, such as "v1" for your starting point and "v2" after a change
Keep your machine's and grinder's instruction manuals with the record. Any preparation steps that are specific to your equipment, such as warm-up or flushing, should come from those manuals, not from a generic guide.
Step 2: Write your preparation sequence as numbered steps
A workflow is only repeatable if the steps happen in the same order each time. Birma's guide describes a general sequence of warming, dosing, distributing, tamping and brewing. Use that as a skeleton, then adjust it to match your equipment's instructions and the tools you actually use.
Give each step its own row with these columns:
- Step number
- Instruction reference: the manual page or source the step comes from
- Planned action: what you intend to do
- Completed: a check mark for this session
- Deviation: anything you did differently and why
| Step | Instruction reference | Planned action | Completed | Deviation |
| 1 | Machine manual | Warm machine and portafilter | ✓ | — |
| 2 | Own method | Weigh beans and grind into dosing cup | ✓ | — |
| 3 | Own method | Transfer grounds to basket and weigh | ✓ | Small spill at transfer |
| 4 | Own method | Distribute grounds | ✓ | — |
| 5 | Own method | Tamp | ✓ | — |
| 6 | Machine manual | Lock in portafilter and brew | ✓ | — |
The table above is an illustrative layout, not a prescribed procedure. The deviation column is the most useful part. It's how you notice that a shot that "just tasted different" came from the day you skipped a step or changed its order.
Step 3: Record single-dose weights at two points
Single dosing means weighing out the beans for one shot and grinding only that amount. Coffeedant's guide separates two quantities that are easy to confuse: the beans weighed before grinding, and the grounds actually delivered to the basket. Its suggested check records both, rather than assuming they're equal.
Here is a hypothetical example of how that looks in a record:
- Beans into grinder: 18.4 g
- Grounds in basket: 18.1 g
- Basket dose to record: 18.1 g
- Input/output difference: 0.3 g
Log the basket weight as your dose, because that is the coffee the water actually passes through. Record the difference separately. On its own, the difference doesn't tell you where the coffee went. Add fields for anything you actually saw, such as grounds left on a dosing cup or funnel, or a spill during transfer. If the gap changes noticeably from one session to the next, those notes are what help you trace the cause.
Step 4: Log each shot
Add one row per shot beneath the preparation sequence. Keep the fields consistent so you can compare shots directly.
- Date and recipe version
- Beans into grinder (g)
- Basket dose (g)
- Grinder setting
- Target yield (g)
- Actual yield (g)
- Shot time, with the start and stop events you used
- Taste and appearance notes
- Decision: keep, adjust or discard this setting, and why
Name your timing events explicitly, for example "from pump start to pump stop." A time recorded without its start and stop points can't be compared reliably with times from other days or from other people's recipes.
The decision field follows another Coffeedant suggestion: document why you kept a working dose. A note like "kept 18.1 g; balanced, no sourness" is more useful later than the bare number.
Setup: [machine + revision] / [grinder] / [basket marking]
Coffee: [roaster, name, roast date]
Recipe: v2 (changed grind from v1)
Date Beans-in Basket Grind Target Actual Time (pump on→off) Notes Decision
2026-11-06 18.4 g 18.1 g [set] 36 g [g] [s] [taste, residue seen] [keep/adjust + why]
Step 5: Version the record and keep changes separate
Once a sequence and recipe produce shots you're happy with, save that combination as a numbered version. When you want to try a different dose, grind or yield, record it as a proposed change in a separate dial-in log rather than editing the accepted version. That way your working baseline stays intact, and you can always go back to it if the experiment doesn't pan out.
Keep general reference material in one place: how you weigh, how you calculate ratios, and which timing convention you use. Your shot rows then don't need to repeat it, and every entry follows the same rules.
What to take from forum workflows
Home baristas often share their workflows on forums and community threads, and these are a good source of ideas for step order and tools. Read any posted dose, yield or time as tied to that person's machine, grinder, basket and coffee. Adopt the structure if it fits your setup, then fill in your own measured numbers using the record above.
Related articles
Record a Bruer cold-drip brew from setup to beverage yield
A practical log for a Bruer cold-drip session: method check, Bruer's setup quantities, drip-rate counting, timing events, collected beverage and cleanup notes.
Organize Existing Coffee Equipment Around Your Brewing Workflow
Set up a DIY home coffee station using only what you own: map your brewing sequence, group tools by use, check placement, and record a repeatable routine.
Keep a personal tasting record as one coffee brew cools
A practical guide to recording successive tasting notes from a single coffee brew as it cools, using elapsed time, measured temperatures and clear comparisons.
Identify and record your espresso machine's preinfusion phase
How to find your espresso machine's documented preinfusion phase, copy its controls and units, and log observed phase events in a brew journal tied to each shot.
Interpret and record espresso pressure readings in context
Looking for the optimal bar pressure for espresso? Learn what your gauge actually measures, how to tell a setting from a reading, and how to log pressure so your numbers can be compared.
Record espresso basket dimensions, dose ratings and headspace
58mm espresso baskets share a diameter but differ in depth and dose range. How to record basket specs, actual doses and headspace checks without guessing at fit.
Record espresso pressure and flow profiles as separate observations
Build a stage-by-stage espresso profile record that keeps intended settings, measured pressure, measured flow and inferred curve segments apart.
Record a Nel Drip Recipe, Pouring Sequence and Beverage Yield
Build a cloth-filter brewing journal that keeps the author's nel drip method intact, logs each pour and pause as it happens, and records beverage yield as its own measurement.
Build a model-specific percolator brewing journal
Record your percolator's model, instructions, heat source, brewing events and completion cues so you can repeat a stovetop or electric routine and compare recipes fairly.
Document espresso spraying and uneven flow before changing preparation
Build a repeatable espresso observation record that separates what you saw, like spraying or uneven flow, from what you suspect caused it and what you change next.