What staling actually is
Updated
On this page7
Two things happening at once
The aromatic compounds that give fresh coffee its smell are volatile and leave over time, and the oils oxidize to produce flat, cardboard and eventually rancid notes. The first is a loss and the second is an addition, and together they are what people mean by stale.
Oxygen is the main driver
It reaches the inside of a porous bean readily, and it is in the headspace of any container that is not full. Reducing it is the single most effective thing packaging can do, which is why valve bags, nitrogen flush and small formats all exist.
Moisture
Roasted coffee is dry and hygroscopic, meaning it pulls moisture from the air. Absorbed moisture accelerates the chemistry and ruins the texture of a grind, and it is the main reason a coffee stored in a humid kitchen goes off faster than one in a dry pantry.
Heat
Everything above runs faster warm. A bag stored next to a stove or an espresso machine is aging at a rate the date on it does not describe, and this is one of the few things a customer controls entirely.
Light
Less important than the other three for coffee, and worth avoiding anyway, which is why most coffee packaging is opaque. For matcha and for delicate green teas it matters considerably more because color is the quality signal.
Time, which is the one you cannot fix
The clock starts at roasting. Everything above decides how fast it runs, and none of it stops it. That is why a roast date is more useful to a buyer than a best-before, and why printing one is a commitment to turnover.