my keurig k-cafe special edition just shows 'add water' but the reservoir is completely full, what's the deal?

Diagnosis

The "Add Water" error on the Keurig K-Cafe Special Edition, despite a full reservoir, is almost always caused by a failure in the magnetic float system. Inside the water reservoir, there is a small, buoyant plastic ring (the float) that contains a permanent magnet. As the water level rises, the float lifts, triggering a reed switch (a magnetic sensor) located in the base of the machine. When the machine doesn't detect the magnetic field of the float at the correct height, it triggers the "Add Water" alert to prevent the pump from running dry and burning out.

This failure typically happens for two reasons: physical obstruction or mineral calcification. Limescale buildup from hard water can create a "crust" around the float or the walls of the reservoir, effectively pinning the float in the "down" position even when the tank is full. In other cases, a small piece of debris or a coffee ground fragment can lodge itself under the float, preventing it from rising. You can confirm this by removing the reservoir and gently shaking it; if the float doesn't slide smoothly up and down the inner channel, the sensor mechanism is compromised.

How to Fix It

Follow these steps to reset the float and clear the sensor path:

1. Power down the machine and unplug the power cord from the wall outlet to ensure no electrical current is running to the internal pump.
2. Lift the water reservoir straight up and out of the K-Cafe base.
3. Locate the float—the small, white or translucent plastic ring inside the reservoir's vertical channel.
4. Using a clean, lint-free microfiber cloth dipped in white vinegar, scrub the interior walls of the reservoir channel and the exterior of the float. This removes the calcium carbonate (scale) that causes the float to stick.
5. Gently push the float up and down using a plastic straw or a chopstick to ensure it moves freely through the entire range of motion without any resistance.
6. Inspect the bottom of the reservoir for any slime or biofilm buildup that might be acting as a "plug" at the base of the float channel. Scrub this area thoroughly.
7. Refill the reservoir with filtered water and firmly seat it back into the base, ensuring it clicks into place to align the float with the internal reed switch.
8. Plug the machine back in and power it on.

If That Didn't Work

• Perform a Hard Reset: Unplug the machine for exactly 60 seconds. While unplugged, press and hold the "K-Cup" button for 10 seconds to discharge any remaining capacitors. Plug it back in and attempt to brew. This clears temporary logic glitches in the control board.
• Deep Descale: If the float is moving but the error persists, there may be scale buildup inside the internal tubing that is tricking the pressure sensor. Run a full descaling cycle using a commercial Keurig descaling solution or a 50/50 mix of white distilled vinegar and water. Run a full brew cycle without a pod three times to flush the system.
• Check the Reservoir Seal: Inspect the rubber O-ring at the bottom of the reservoir. If the seal is cracked or leaking, the machine may be detecting a loss of prime, which it sometimes misinterprets as a "low water" state. Replace the reservoir if the plastic housing has a hairline crack.
• Manual Float Manipulation: With the reservoir installed, try gently lifting the reservoir up and down by a fraction of an inch while the machine is on. If the "Add Water" message disappears momentarily, the internal reed switch is likely misaligned or failing and may require a professional replacement of the base assembly.

Heads Up

• Avoid using dish soap to clean the reservoir; the suds can create air bubbles (cavitation) in the pump, which can trigger false water-level errors.
• If you live in a hard-water area, descale your K-Cafe every 3 months to prevent the float from seizing again.
• Never force the float upward with a metal tool, as scratching the plastic channel can create "burrs" that will permanently trap the float.
• Ensure you are using the official Keurig reservoir; third-party replacements often have slightly different magnet strengths that may not trigger the K-Cafe's specific sensor.