Espresso Shot Planner

Style preset:

Choose a baseline, then tune dose, yield, and timing.

Dose:

Enter dry coffee grams, e.g. 18.0 for a double basket.

Target ratio:

Enter beverage-out side of 1:x; 2.00 means 18 g in to 36 g out.

Target yield:

Enter target beverage grams when you know the desired output.

g out

Shot time target:

Current accepted window: {{ timeRangeLabel }}.

Water temperature:

Enter brew temperature; unit switch keeps C/F values synchronized.

Dose used:

Leave at plan dose unless the basket weight changed.

Yield and time:

Enter cup grams first, then elapsed seconds from pump on.

g out s

Flow or pressure note:

Use short cues such as gentle ramp, channeling, or held 8.5 bar.

Taste note:

Write one tasting line, e.g. sweet, sharp, hollow, bitter, or dry.

Grinder note:

Use model and setting, e.g. Niche 6.5 or SSP HU 4.2.

Time flex: ±{{ time_window_s }} s

Slider sets seconds on each side of the target time.

Ratio tolerance: ±{{ formatNumber(ratio_window, 2) }}

Example: 0.15 keeps 1:2.00 within 1:1.85-2.15.

Preinfusion:

Enter soak seconds and pressure bar, e.g. 6 s at 2.5 bar.

s bar

Peak pressure:

Enter main-pull pressure; common pump targets are 6-9 bar.

bar

Finish pressure:

Enter final bar target, or 0 when the profile stays flat.

bar

Finish flow target:

Enter expected late-shot flow, e.g. 1.3 g/s.

g/s

Field	Target / Notes	Copy
{{ row.field }}	{{ row.value }} {{ row.hint }}

#	Timestamp	Dose	Yield	Time	Ratio	Notes	Copy
No shots recorded yet Use the Advanced shot log workspace to add pulls before exporting this ledger.
#{{ entry.seq }}	{{ entry.timestamp }}	{{ entry.doseDisplay }}	{{ entry.yieldDisplay }}	{{ entry.timeDisplay }}	{{ entry.ratioDisplay }} {{ entry.deltaRatio }}	{{ entry.notes }} {{ entry.flowNote }} {{ entry.taste }} {{ entry.adjustment }}

Embed:

Customize

Include current inputs

Size

Advanced

Width

Height

Aspect ratio

Max height

Collapsible embed

Allow fullscreen

Referrer policy

Sandbox tokens

Good espresso is not defined by one magic number. A shot is a small, pressurized brew where dry coffee, grind size, puck prep, water temperature, pressure, beverage weight, and time all affect the cup at once. That is why baristas usually write espresso recipes as a set of linked targets rather than as a single instruction such as "pull for 30 seconds."

The most useful anchor is brew ratio: dry coffee dose compared with beverage yield. An 18 g dose and a 36 g beverage is a 1:2 recipe. A shorter recipe such as 1:1.8 tends to feel denser and stronger, while a longer recipe such as 1:3 can taste lighter and more open. Ratio does not explain the whole shot, but it gives the grinder, scale, and timer a shared reference.

Dose: The dry ground coffee placed in the basket, measured in grams.
Yield: The beverage mass in the cup, also measured in grams so crema volume does not distort the reading.
Shot time: The elapsed time for the extraction, commonly measured from pump start or first water contact depending on the workflow.
Flow rate: The average beverage output per second. It is a useful clue, not proof that water moved evenly through the puck.

Espresso recipe variables connecting dose, puck resistance, beverage yield, time, and taste notes

Time matters because it shows how quickly the target beverage mass arrived. A fast 36 g shot and a slow 36 g shot share the same ratio but not the same flow behavior. Grind size, distribution, tamp consistency, preinfusion, pump pressure, roast age, and basket shape can all change the resistance of the coffee bed, so two shots with the same dose and yield can taste very different.

The practical limit is that espresso numbers are evidence, not verdicts. A recipe can keep a bar consistent, help a home setup recover after changing beans, and make a tasting session less random. It still cannot replace the final sensory check: sweetness, acidity, bitterness, body, aftertaste, and any sign of channeling need to be read beside the scale and timer.

How to Use This Tool:

Use the planner when you want a target recipe before grinding and a measured record after each pull. The visible plan updates as dose, ratio, yield, time, temperature, pressure, and tolerance values change.

Choose Style preset for a starting profile such as Balanced double (1:2), Syrupy ristretto (1:1.8), Turbo shot (1:2.4 fast), Allongé (1:3), or Competition sweet (1:2.2). The summary should show the planned yield, time window, flow band, pressure badge, and water temperature.
Set Dose, Target ratio, or Target yield. Ratio and yield stay linked: changing a 18 g dose at 1:2 gives 36 g out, while editing yield directly recalculates the ratio.
Adjust Shot time target and Water temperature. Open Advanced if you need Time flex, Ratio tolerance, Preinfusion, Peak pressure, Finish pressure, or Finish flow target to match the machine and coffee.
Pull the shot, then record Dose used, Yield and time, Flow or pressure note, Grinder note, and Taste note. Record shot stays unavailable until dose, yield, and time are all positive numbers.
Read Recipe Table before changing the grinder. It gives the target yield, accepted time window, average flow range, pressure plan, profile focus, and water temperature in one place.
Use Shot Log, Time Ratio Chart, and Extraction Map after one or more pulls. Copy or download the table, chart, DOCX, CSV, or JSON outputs when you need a record outside the current page session.

For a clean dialing session, keep the dose and basket stable for a few pulls, change one main variable at a time, and write short taste notes that you can compare with the ratio and flow results.

Interpreting Results:

Start with Target yield, Shot time, and Average flow. If yield is correct but time is short, the shot is fast for the recipe. If time is correct but yield is high, the ratio is longer than planned. If both are inside the tolerance bands, the numbers are stable enough that taste can guide smaller changes.

Espresso planner result areas and interpretation checks
Result area	What to trust	What to verify
Recipe Table	The planned dose, yield, time window, flow band, pressure plan, profile note, and water temperature.	Check that the selected preset still matches the coffee, roast level, basket size, and machine pressure behavior.
Shot Log	Actual ratio, ratio drift, time drift, average flow, taste note, and suggested adjustment for each recorded pull.	Confirm that the logged dose, beverage mass, and time came from the same pull before acting on the suggestion.
Time Ratio Chart	Whether logged shots cluster inside the accepted time and ratio window.	Do not treat a point inside the box as automatically delicious; taste and evenness still matter.
Extraction Map	Ratio drift against flow rate, labeled as short, long, slow, fast, or on target.	Use the map as a dialing aid, not as a channeling detector or extraction-yield measurement.

A common false-confidence trap is chasing the time window after the cup already tastes balanced. If a shot lands slightly fast but tastes sweet, clean, and full enough for the drink you are making, record it as a useful recipe instead of forcing it toward a generic number.

Technical Details:

Espresso recipe math is mass-based. Dose is the dry coffee mass, yield is the beverage mass, and brew ratio is the beverage mass divided by dose. Measuring yield by weight is important because crema volume changes quickly and can make a short shot look larger than it is.

Average flow rate is derived from yield and time. It does not describe the full flow curve through the puck, but it gives a compact way to compare pulls when the same dose, basket, and target recipe are being used. A lower average flow usually means the beverage arrived more slowly; a higher average flow means it arrived more quickly.

Formula Core:

The core recipe calculations are deterministic. The pressure and taste fields add context, while the target ratio, yield, time, and tolerance settings define the numeric comparison bands.

Espresso shot planner formulas and variable meanings
Quantity	Formula	Meaning
Target yield	$Y_{target} = D R_{target}$	Dose multiplied by the chosen 1:x ratio.
Actual ratio	$R_{actual} = \frac{Y_{actual}}{D_{actual}}$	Logged beverage mass divided by logged dry dose.
Average flow	$F = \frac{Y}{T}$	Beverage yield divided by elapsed shot time, in grams per second.
Time window	$T_{\min} = T - w, T_{\max} = T + w$	Target time plus or minus the selected time flex.
Flow band	$F_{\min} = \frac{Y}{T_{\max}}, F_{\max} = \frac{Y}{T_{\min}}$	The slow and fast average-flow boundaries implied by yield and the accepted time window.
Temperature conversion	$T_{F} = (T_{C} \frac{9}{5}) + 32, T_{C} = (T_{F} - 32) \frac{5}{9}$	Keeps the brew-temperature target synchronized when switching between Celsius and Fahrenheit.

For a 18 g dose at 1:2, target yield is 36 g. With a 29 s target and 3 s time flex, the accepted window is 26 s to 32 s. The corresponding average-flow band is 36 divided by 32 to 36 divided by 26, or about 1.13 g/s to 1.38 g/s.

Rule Core:

Espresso shot comparison rules
Condition	Boundary	Result meaning
On ratio	`\|actual ratio - target ratio\| <= ratio tolerance`	The beverage weight is close enough to the target recipe.
Short ratio	`actual ratio < target ratio - tolerance`	The logged shot stopped short of the target beverage mass for the dose.
Long ratio	`actual ratio > target ratio + tolerance`	The logged shot ran longer than the target beverage mass for the dose.
On time	`target time - flex <= actual time <= target time + flex`	The shot duration is inside the selected time band.
On flow	`flow minimum <= actual flow <= flow maximum`	The beverage arrived within the average-flow range implied by the plan.

Temperature conversion follows the same linear Celsius and Fahrenheit equations shown in the Formula Core. The pressure fields describe the planned extraction profile, including preinfusion and a peak-to-finish taper, but they do not change the ratio or flow formulas.

Accuracy and Privacy Notes:

The planner is a recipe and logging aid, not a sensory judge or a laboratory extraction-yield test. It can show whether a pull matched the selected dose, yield, time, and tolerance bands, but it cannot see channeling, puck cracks, grinder retention, water chemistry, roast age, or uneven extraction.

Use the same timer convention across a session. Mixing pump-start timing with first-drop timing makes repeat pulls harder to compare.
Keep basket size, puck prep, and dose stable when judging grinder changes. Changing several variables at once can make the adjustment advice misleading.
Calculations, visible logs, and exports are generated from the values in your browser. Export the log if you need a durable record after leaving the page.

Worked Examples:

A balanced double starts with Dose at 18.0 g, Target ratio at 1:2.00, Target yield at 36.0 g, and Shot time target at 29 s with 3 s of Time flex. Recipe Table shows a 26 s to 32 s window and an Average flow band of about 1.13 g/s to 1.38 g/s. If the logged pull reaches 36.0 g in 24.0 s, Shot Log keeps the ratio on target but marks the time as 5.0 s fast and reports a flow near 1.50 g/s, so the next change should focus on slowing the pull rather than raising yield.

A turbo-style recipe uses a longer target ratio and a shorter time band. With 18.0 g in at 1:2.40, the planned beverage is 43.2 g. If Yield and time records 43.0 g in 21.0 s, the actual ratio is about 1:2.39 and average flow is about 2.05 g/s. That fits the fast profile better than it would fit the balanced preset, which is why comparing the same pull against the selected preset matters.

A troubleshooting case starts when Record shot remains unavailable because one of the required log values is zero or blank. Enter the actual Dose used, cup yield, and elapsed seconds first, then add the flow note and taste note. Once the shot is recorded, check whether the warning is about ratio drift, time drift, flow drift, or a combination before changing the grinder.

FAQ:

Is 1:2 always the correct espresso ratio?

No. The balanced preset uses 1:2 because it is a common starting point, but the planner also includes shorter ristretto-style, faster turbo, longer allongé, and 1:2.2 sweet-profile starts. The best ratio is the one that fits the coffee, basket, drink, and taste target.

Why does editing yield change the ratio?

Brew ratio is yield divided by dose. When Target yield changes directly, the planner recalculates Target ratio; when dose or ratio changes, it recalculates the target yield.

Why can a shot be on ratio but still flagged as fast?

Ratio only says how much beverage was made from the dose. A 36 g shot from 18 g of coffee is still 1:2 whether it took 24 seconds or 31 seconds, but the faster pull has a higher average flow and may need a different grind, preinfusion, or puck prep.

Does the Extraction Map diagnose channeling?

No. Extraction Map compares ratio drift with average flow. Channeling can create sour and bitter flavors in the same shot, but a map point cannot prove what happened inside the puck without visual, taste, and prep evidence.

Will the shot log stay saved after I leave?

Treat the visible Shot Log as a session record. Use the CSV, DOCX, JSON, row-copy, or chart download actions when you need to keep the plan or pull history.

Glossary:

Dose: The dry coffee mass placed in the espresso basket.
Yield: The finished beverage mass in the cup.
Brew ratio: The relationship between dose and yield, written as 1:x for this planner.
Time flex: The allowed number of seconds on each side of the target shot time.
Ratio tolerance: The allowed brew-ratio drift before a logged pull is treated as short or long.
Preinfusion: A lower-pressure wetting phase before the main extraction pressure.
Pressure profile: The planned pressure behavior across the shot, including peak pressure and finish pressure.

References:

Defining the Ever-Changing Espresso, Specialty Coffee Association.
Influence of Flow Rate, Particle Size, and Temperature on Espresso Extraction Kinetics, Foods, 2023.
The Espresso Compass, Barista Hustle, 2017.