Free espresso diagnostic tool

Espresso Shot Troubleshooter Find the next useful adjustment

Describe the main problem, how you are measuring the recipe and what happens at the target yield. The tool will suggest a controlled first step without pretending that one symptom proves one cause.

A more reliable diagnosis

Three rules before moving the grinder

01
Measure dose and beverage weightShot time without a defined output does not describe the same recipe.
02
Separate taste from appearanceCrema colour and puck wetness are weaker clues than flow, weight and flavour.
03
Change one variableKeep the dose and target yield stable while testing a grind or preparation change.
No fixed 18g ruleUse a dose appropriate for the basket and machine.
No universal 30-second passTime is a diagnostic reference rather than the definition of success.
Cleaning is not descalingCoffee oils and mineral deposits require different maintenance.
Appearance is supporting evidenceTaste and a measured recipe carry more weight than crema alone.
Diagnose the shot

Four observations to narrow the possibilities

Choose the description closest to what you actually observe. Contradictory answers are useful: a fast but bitter shot, for example, can suggest uneven flow rather than a simple grind problem.

Question 1 of 4

What is the main problem with the shot?

Begin with the clearest observation rather than the cause you suspect.

Try this first

Keep these stable

    Check these alternatives

      Your observations

      Main problem
      Specific symptom
      Measurement
      Flow to target
      Worth knowing

      Build a useful baseline

      The four measurements worth recording

      You do not need laboratory equipment. A small scale and timer are enough to turn a vague bad shot into a repeatable recipe that can be adjusted.

      01 · Dose

      Dry coffee in the basket

      Use a dose that suits the basket. Reweigh after grinding when retention means the delivered amount may differ from the grinder input.

      02 · Yield

      Liquid espresso in the cup

      Tare the cup and stop by beverage weight. Crema makes volume a less repeatable comparison between shots.

      03 · Time

      How long the recipe takes

      Record consistently from the same point each time. Use the number to compare flow, not as a universal pass or fail test.

      04 · Taste

      What changes as it cools

      Taste before adding milk and again when the espresso is comfortably warm. Sharpness, dryness and sweetness can become easier to separate.

      Pressurised baskets behave differently

      A dual-wall or pressurised basket creates resistance differently from a traditional single-wall basket. Flow and crema clues may therefore be less directly connected to grind and puck preparation.

      A sensible order of operations

      Fix the foundation before fine-tuning temperature

      Many frustrating dial-in sessions come from changing grinder, dose, ratio and temperature together. Work through the variables in an order that leaves the result interpretable.

      01

      Warm, flush and clean

      Use fresh water, allow the machine and portafilter to warm properly, and make sure the basket and shower area are free from old coffee residue.

      02

      Set dose and target yield

      Choose a basket-appropriate dose and a repeatable brew ratio. These become the fixed boundaries for judging the grinder adjustment.

      03

      Adjust grind and preparation

      Move the grinder in small steps and improve distribution when flow is uneven. Consider temperature only after the measured recipe is reasonably controlled.

      Clues that are easy to overread

      Appearance can help, but it rarely settles the diagnosis

      Visual information is most useful when it agrees with the measured flow and flavour. On its own, it can send the grinder in the wrong direction.

      No crema

      Freshness can affect crema, but roast, species, basket type and extraction also matter. No crema is not proof that the beans are unusable.

      Pale or dark crema

      Colour varies with the coffee and roast. Use it as a supporting clue rather than a direct under- or over-extraction meter.

      A wet puck

      Headspace, basket dose and whether the machine has a three-way solenoid affect puck appearance. A wet puck is not automatically a failed shot.

      Tiger striping

      Striping can appear in attractive extractions and does not prove channelling. Spraying, one-sided flow and inconsistent taste are stronger warnings.

      Frequently asked questions

      Troubleshooting home espresso

      The aim is not to force every coffee into one recipe. It is to make the next change small, controlled and easy to compare.

      Does a sour espresso always need a finer grind?

      No. A fast, thin and sharply sour shot often benefits from a finer grind, but bright coffee character, low temperature, a short ratio or uneven extraction can produce similar sensations.

      Does a bitter espresso always need a coarser grind?

      No. Slow flow and harsh bitterness make that a sensible first test, but roast level, a long yield, high temperature or dirty equipment may also contribute.

      Should every double espresso use 18g?

      No. The appropriate dose depends on the basket and machine. Use the basket’s intended range and keep that dose repeatable while adjusting the recipe.

      Is 25–30 seconds the correct time for every shot?

      No. It is a common reference range for many espresso recipes, not a universal definition of a good result. Dose, yield, coffee and machine all affect the useful time.

      Why is a fast shot sometimes bitter?

      Uneven extraction can allow water to rush through channels while other parts of the puck extract harshly. Check distribution and flow before simply grinding finer.

      Does tamping harder slow the shot?

      Once the coffee bed is compressed, extra force has limited value. A level tamp and even distribution are generally more useful than trying to reproduce an exact heavy pressure.

      Should I descale when coffee tastes bitter?

      Not automatically. Old coffee oils can make drinks taste bitter and are removed through cleaning or backflushing where supported. Descaling addresses mineral deposits and should follow the machine instructions.

      When should I stop troubleshooting and check the machine?

      Stop and follow the manufacturer’s support guidance when the pump does not run, water leaks, the machine smells electrical, unusual noises persist or a strong cleaner taste remains after thorough rinsing.

      Method note: the result combines the reported symptom, measurement method and flow behaviour. It deliberately uses “likely” language because several espresso faults can create similar taste or appearance clues.