A coffee journal fails in one of two ways. Either you never start, or you start and quit in week two because it feels like homework.
What to track in your espresso journal covers the fields. Coffee journal: what to track and why covers why bother in the first place. This post is about the workflow. The actual daily, weekly and bag-end rituals that turn logging into learning without feeling like a second job.
The daily log: 30 seconds, while the puck is extracting
The most important rule in coffee journaling: log the shot before you drink it, not after.
The 20 seconds after the pump stops is the only window where your dose, yield, time and grind are all in short-term memory. Wait until you've sipped, made a face and started a conversation about the beans, and you will round-number everything. Precision is gone.
Here is the actual flow, step by step. Do this at the machine, before you pick up the cup.
- 1.Weigh the portafilter, note the dose. You already did this to pull the shot. Write it down now, to 0.1g.
- 2.Weigh the cup, note the yield. Same thing. 0.1g precision.
- 3.Note the time. Your shot timer already knows. If you use the built-in timer in a tracking app, this is automatic.
- 4.Grind setting. You set it before pulling. It's still on the grinder. Log it.
- 5.Taste. Rate. One sentence. This is the only step that needs actual attention. Sip. Pick a number out of 10. Type one sentence. "Juicy, plum, clean finish." "Muddy, bitter tail." "Fine but forgettable." Thirty seconds of writing.
Done. Total time: 20 to 30 seconds. Less than the extraction itself.
The one-handed rule
Your workflow needs to work while the other hand is holding a cup or wiping down a bar. That rules out anything fiddly. Pick a log format that takes taps and numbers, not typing paragraphs.
If you're using a tracking app, the happy path is: tap plus, enter three numbers, tap rating, type one sentence, tap save. On paper, it's one row in a table. In a spreadsheet on mobile, it's painful. Pick your medium honestly.
The weekly review: 10 minutes, Sunday morning
This is where the journal stops being a data dump and starts being a feedback loop.
Every week, filter your last seven days of shots. Look at four things:
Average rating. Is it trending up, down, flat? If you're stable at 7.5 and have been for two weeks, your current recipe is the plateau. Tweak something deliberately next week.
Best shot. What did you do differently? Was it a specific bean, a specific ratio, a specific time of day? Write the conditions down somewhere you'll see them.
Worst shot. What happened? Usually there's a traceable story: an old bag, a new grinder setting you forgot to undo, a rushed pull. Naming it is half the defence against repeating it.
Ratio distribution. Are you accidentally drifting? If you intended to pull 1:2 all week but your actual ratios are 1:1.8, 1:2.4, 1:2.1, 1:2.6, you're not as consistent as you think. This is where a tracking app beats a notebook. PUCK YEAH! shows this automatically under its stats tab.
Ten minutes. Once a week. The difference between logging and learning is this review.
Don't over-review
Daily reviews are a trap. You don't have enough data in a single day to see patterns. All you'll do is over-react to one bad shot and change three variables before tomorrow, which means nothing will be diagnosable.
Weekly is the right rhythm. You want enough shots to see a signal through the noise.
The bag-end review: write the eulogy
Every bag of beans has a lifecycle. You buy it at day 4 post-roast, dial it in by day 7, hit its peak around day 12 to 21, and it starts fading by day 30. Somewhere in that window you finish it.
The moment you finish a bag is the most underused learning moment in home espresso. Before you open the next one, write two to four lines:
- What ratio worked best?
- What grind setting stabilised at?
- Best single shot with this bean (date + parameters)?
- Would you buy it again?
Even just those four lines, saved against the bean, turn your next encounter with that roaster or origin into a hot start rather than a cold one. If you ever buy the same bag again, you already know the recipe. If you try something adjacent (same roaster, different origin), you have a baseline to adjust from.
Most apps don't prompt for this. PUCK YEAH!'s bean detail view surfaces your best recipe and your average rating automatically when the bag closes, so you get the retrospective for free. Paper journals need you to add this step manually. It's worth the effort either way.
Failure modes: what kills journals in week two
Skip-day paralysis. You miss two days. Now you feel you need to "catch up" from memory. Don't. Backfilled data is garbage and pollutes your trend lines. Start again today. The journal doesn't care about streaks. You do.
Over-tracking. You start logging temperature, pressure, ambient humidity, barometric pressure, tamping pressure and which song was playing. Within a week you're logging six fields you never use. Drop everything you haven't referenced in a review. The non-negotiables are dose, yield, time, grind, bean, rating. Everything else is optional.
Under-tracking. You log dose, yield and rating. That's it. No tasting notes, no grind setting, no bean. Six weeks later your journal is a list of numbers with no story. Worthless for diagnosis. The sentence of tasting notes is the one optional field that pays for itself ten times over.
Making it a chore. If you ever catch yourself thinking “I should log that shot” as a task, the workflow is wrong. Logging should feel like weighing the dose. Part of the ritual, not an extra thing on top. Shorten the process or change the medium.
Comparing yourself to the journal. Some weeks you'll pull bad shots. Don't hide them by not logging. The journal is useful precisely because it's honest. The worst weeks teach more than the best weeks.
Two example workflows
The minimalist
You pull one shot a day, most mornings. You want the habit without overthinking it.
- Daily: dose, yield, time, grind, rating, one-sentence note. 20 seconds at the machine.
- Weekly: 5 minute glance on Sunday. Just look at average rating and best shot.
- Bag-end: one line: best ratio, star rating out of 5, would buy again yes/no.
Total weekly time investment: about 10 minutes. Expected benefit after a month: you know which of your beans are worth rebuying and roughly what ratio suits your roast level.
The obsessive
You pull 3 to 6 shots a day. You have multiple grinders. You're actively experimenting.
- Daily: all core fields plus temperature, pressure, basket, grinder loadout, photo of pour. 45 seconds per shot.
- Weekly: 20 minute Sunday session. Rating trend, best and worst shot breakdown, ratio distribution, grinder drift check, bean freshness by days-off-roast.
- Bag-end: full retrospective. Best recipe, grind progression from day 4 to day 30, peak window, tasting-note evolution, next-bag plan.
Total weekly time investment: about 90 minutes. Expected benefit: you're publishing roast reviews that hold water and your dial-in time for new bags is under 3 shots.
Most people sit between these two extremes. Pick the level of commitment that matches how much you actually care, not how much you think you should care.
The tools question
You can run this workflow on paper, in a spreadsheet, or in an app. All three work. The trade-offs are:
- Paper is highest friction for review (no search, no filters, no trend calculations) but lowest friction for entry. Works for the minimalist workflow. Dies under the obsessive one.
- Spreadsheet is medium friction for entry and medium friction for review. Requires template setup. Works well for the middle profile if you're already spreadsheet-fluent.
- Dedicated app is lowest friction for both entry and review, but introduces platform risk (if the app shuts down or goes aggressively paid, your workflow breaks). Mitigate by only picking apps that export your data in a readable format.
How to choose an espresso tracking app covers the criteria for picking an app you won't regret.
Start today
The workflow that works is the one you'll actually do. Pick the minimalist version. Log one shot this afternoon. Do it again tomorrow. Review on Sunday. That's it.
A week of messy notes beats a year of perfect intentions. The journal you keep beats the journal you plan.
PUCK YEAH! does all of this in about 20 seconds per shot, free, no signup. But the medium is less important than starting. Pen and paper works too. Just pick one and go pull a shot.
Further reading
- Coffee journal: what to track and why. The case for journaling in the first place, plus the field-by-field breakdown.
- What to track in your espresso journal. The original deep dive on why each variable matters.
- How to dial in espresso. The full process a good journal makes three times faster.
- How to taste espresso. The framework behind useful tasting notes.