How long to rest your beans
Fresh-off-the-roaster coffee isn't actually at its best the day it's roasted — it's still full of trapped CO₂ that hasn't finished escaping, and that gas gets in the way of even extraction. Filter and French press are the most forgiving methods here: both are genuinely ready anywhere from 4 to 14 days after roasting, which is why so many bags list a roast date instead of a "best by" date — the useful clock starts there, not at packaging.
Espresso is pickier. The combination of high pressure and a fine grind means leftover CO₂ doesn't just sit passively in the cup — it actively pushes back against water trying to pass through the puck, producing the telltale thick, fast "bloom" and crema that can mask a shot that's actually under-extracted underneath. That's the whole reason the espresso window — 10 to 21 days — runs later and wider than filter's. A light roast pushes it later still: because light roasts hold onto more CO₂ for longer (a bigger τ), a light-roast espresso's window shifts a further week out, to 17–28 days. Dark and medium roasts degas quickly enough that they don't need the extra week.
Degassing and CO2, the chemistry
Roasting is a controlled pyrolysis reaction: heat drives off water, then triggers the
Maillard reaction and caramelization that build coffee's flavor compounds, and along the
way it also produces carbon dioxide — trapped inside the bean's now-porous cell
structure, sometimes several times the bean's own weight in gas for a dark roast. That
CO₂ doesn't vanish at the end of the roast; it keeps escaping afterward, fastest in
the first day or two (which is why a very fresh bag can look almost alive when hot water
hits it) and more slowly from there, following the same exponential decay used elsewhere
in this Brew Lab: degassed(t) = 1 − e^(−t/τ). A medium roast
reaches 63.2% degassed at exactly one τ (8 days) and roughly 95% by 3τ (24 days)
— never a hard "done," just diminishing enough to stop mattering.
This is also why grinding accelerates staling so dramatically: whole beans have a relatively small surface area exposed to air, but grinding shatters that structure and multiplies the exposed surface area many times over, which is why "grind right before you brew" is close to universal advice among roasters. For the deeper chemistry of what heat does inside the bean during roasting itself, see our guides on coffee roasting chemistry and how roasting transforms green beans.
Storing your coffee once it's opened
Sealed, one-way-valve bags are designed to let residual CO₂ escape without letting oxygen in — which is exactly why "sealed" is this calculator's baseline fade rate. The moment you open a bag, though, every scoop lets a little more oxygen in, and oxidation (not CO₂ loss) becomes the dominant force behind staling from that point forward. This tool models an opened bag as fading roughly twice as fast, past its peak window, as a sealed one.
The fix is simple and well worth the five extra seconds: reseal tightly after every use, store in an airtight, opaque container (light degrades flavor compounds almost as efficiently as oxygen does), and keep it away from heat sources. Skip the refrigerator for everyday storage — it's not cold enough to meaningfully slow staling but is humid enough to risk condensation forming on the beans every time the container is opened. Our full storage walkthrough — container choices, humidity control, vacuum sealing — is in Home-Roasted Coffee Storage: Keep Beans Fresh Longer.
Freezing coffee: myth versus reality
"Never freeze your coffee" is outdated advice built around a real but avoidable failure mode: repeatedly pulling a bag in and out of the freezer lets warm, humid air condense on cold beans every single time, and that moisture is genuinely bad for flavor. Freeze correctly, though, and the opposite is true — cold temperatures meaningfully slow both oxidation and further CO₂ loss, which is why this calculator treats "frozen" as pausing the freshness clock rather than continuing to advance the fading curve.
The practical version: portion your beans into smaller airtight containers or bags before freezing (so you're only ever thawing what you'll use in a day or two), and once thawed, don't refreeze. Whole beans freeze far better than ground coffee, for the same surface-area reason grinding accelerates staling at room temperature. Done this way, freezing is a legitimate way to bank beans you can't get through inside their normal window — not a fallback, a genuinely useful tool.
Methodology & limitations
This tool models two coupled but distinct processes — CO₂ degassing (an exponential curve driven purely by roast level) and a generic peak-then-fade flavor window (days 10–25, independent of method) — alongside per-method rest windows that determine the state and brew-by date you see above. A few honest simplifications, named plainly:
- No separate "date opened" input. The opened-storage fade acceleration is approximated from the peak window's end rather than the exact day you broke the seal, since in practice most bags are opened around when brewing from them begins.
- Roast level is the only input that shifts τ. Bean density, origin, processing method and even altitude all affect real-world degassing speed at the margins; this tool uses three representative presets rather than modeling every variable.
- A guide, not a guarantee. Water quality, grind, dose and brew technique all matter as much as bean age for what ends up in your cup — this calculator tells you when the beans are ready, not that any given recipe will taste good.
