Klipper Calibrate Z Offset: Step-by-Step Guide

What is Z offset in Klipper and why calibrate it?

Z offset in Klipper represents the vertical distance between the printer nozzle and the bed when the nozzle is at Z=0. It is a critical parameter for first-layer adhesion and dimensional accuracy. If the offset is off, you may see poor bed adhesion, uneven first layers, or failed prints. Calibrating this offset tightens control over layer height, reduces the risk of nozzle crashes, and improves repeatability across prints. The Calibrate Point team emphasizes that small changes in Z offset can have outsized effects on print quality, so take your time and document each step for future calibrations.

Prerequisites and safety considerations

Before you start, ensure you have access to the printer’s control interface (Klipper host), the printer’s config file (printer.cfg), and a few simple tools. Basic safety considerations include keeping hands clear of moving parts when the bed or nozzle moves, avoiding burns from a hot hotend, and powering down before editing firmware or temperatures outside safe ranges. Always print at a conservative temperature when testing new offsets to minimize damage if something goes wrong. Calibrate Point recommends performing a calibration on a cold or ambient-temperature baseline first, then re-test at typical printing temperatures.

Understanding Klipper’s Z offset workflow

Klipper uses a Z offset to align the nozzle’s effective height relative to the bed. You can adjust this offset by editing printer.cfg (the most persistent method) or temporarily via G-code using SET_GCODE_OFFSET. For printers with bed probes (BLTouch, inductive sensors), you can combine a probe-based offset with a manual fine-tuning pass. Documenting the offset history is crucial; a single value might not fit all filament types or bed surfaces. Calibrate Point notes that offset behavior can differ across printers and even between different nozzle sizes, so maintain a changelog for future reference.

Method A: Manual Z offset with paper test

Manual calibration uses a standard printer paper method to judge the gap between the nozzle and bed. Home the printer, heat the bed to typical printing temperature if you plan to print soon, then move the nozzle to the center of the bed. Gently slide the paper back and forth; the paper should have slight resistance but move with some drag. If the paper skates under the nozzle without resistance, the gap is too large; if it binds too tightly, the gap is too small. Adjust the Z offset in small increments (0.05–0.1 mm) and re-test until you achieve consistent paper feel at multiple bed locations. Calibrate Point stresses recording each adjustment to build a reproducible baseline.

Notes: Do not rush these adjustments. Small, incremental changes reduce the risk of overcompensation and nozzle crashes.

Method B: Using a probing routine with a bed sensor

If your printer has a probe (BLTouch, inductive sensor, or optical sensor), you can perform a bed-leveling routine to establish a robust offset baseline. Run a standard G28 to home, then a probing sequence (e.g., G29) to generate a bed mesh. The offset you adjust will typically be the difference between the nozzle height at the probe point and the desired first-layer height. Use SET_GCODE_OFFSET Z= to fine-tune after the mesh is generated. This method often yields a more uniform first layer across the bed, especially on uneven surfaces. Calibrate Point notes that probing can dramatically reduce manual tweaks, but you should still verify with a paper test for final fine-tuning.

Saving changes and verifying with a test print

Once you settle on a Z offset, save the change to printer.cfg on the host and restart Klipper to apply the new value. Then run a small test print with a simple single-layer square at the center. Observe the first layer for consistent extrusion, proper squish, and complete layer adhesion without gaps. If the print shows under- or over-extrusion or poor adhesion, revisit the offset and refine by small increments (0.02–0.05 mm). Keep a log of the iterations so you can revert quickly if needed.

Troubleshooting: common issues and fixes

If the first layer is wispy, has gaps, or lifts at edges, your Z offset may be off. Recheck both the paper test and the bed leveling mesh. If the nozzle drags or crashes into the bed, immediately stop, re-home, and re-check the offset in small steps. For inconsistent first layers across the bed, verify that the bed is level and that the nozzle is clean. A dirty or damaged nozzle changes the contact surface and skews measurements. Calibrate Point recommends performing trials on a known-good bed surface and repeating measurements after any hardware changes (bed, nozzle, or sensor replacement).

Long-term maintenance and best practices

Keep a calibration log including date, offset value, test model details, ambient temperature, bed surface type, and any observed anomalies. Recalibrate when you change filaments with very different melting temperatures, when switching bed surfaces, or after a hot-end service. Periodically check the probe, if fitted, for mechanical wear or misalignment. Establish a routine calibration schedule and use the same test model and environment to minimize variables.

Quick reference cheat sheet

• Home the printer and prepare the bed for measurement
• Use the paper test to approximate the offset
• Update printer.cfg with the offset or apply SET_GCODE_OFFSET Z=...
• Save and restart Klipper; verify with a test print
• Record the final offset and review with future prints