Step by step
How to get your bed mesh as text
Every firmware can print its mesh to the console. Send the command from your printer’s web interface or a serial terminal, copy the reply and paste it above.
| Firmware | Measure | Print the mesh | What to copy |
|---|---|---|---|
| Klipper | BED_MESH_CALIBRATE | BED_MESH_OUTPUT | Everything from “Mesh Leveling Probed Z positions” down. The probed points are used; the interpolated “Measured points” are ignored. |
| Klipper, saved mesh | BED_MESH_PROFILE SAVE=default then SAVE_CONFIG | Open printer.cfg | The [bed_mesh default] block at the end of the file, with its points = rows and min_x to max_y lines. |
| Marlin, bilinear or mesh bed levelling | G29 | M420 V | The “Bilinear Leveling Grid” or “Measured points” table, with or without its row and column numbers. |
| Marlin, UBL | G29 P1 | G29 T or M420 V | The “Bed Topography Report”, including the corner coordinates above and below the map. The comma-separated map from G29 T1 also works. |
| Prusa firmware (MK3 family) | G80 | G81 | “Measured points” and the rows under it. On other models, try M420 V. |
| RepRapFirmware | G29 | Download heightmap.csv | The whole file, from the system files in the web interface. |
| Anything else | Rows of numbers separated by spaces, commas or tabs, one row of the bed per line. |
Heat the bed to printing temperature and let it soak for a few minutes before you measure. Beds change shape as they warm up.
Reading it
How to read a bed mesh
- Each number is a height in millimetres. A positive number means the bed is higher at that point than the printer’s zero; a negative number means it is lower.
- Red is high, blue is low, grey is the middle. Every cell also shows its value, so you never need to rely on the colours.
- Range is the highest point minus the lowest. It is the number most people quote.
- Standard deviation shows how far a typical point is from the mean. One bad corner raises the range a lot but the deviation only a little.
- Tilt is the part of the range that a flat but sloping bed would give. It comes from a best-fit plane through all the points, and it is what bed screws or independent Z motors remove.
- Warp is what is left after the tilt is taken away: the bow, dish or twist of the bed itself. Only mesh levelling, shims or a flatter plate deal with it.
The 3D view stretches heights by the Z exaggeration, or a real bed would look perfectly flat. At ×100, a 0.1 mm bump is drawn 10 mm tall.
Rules of thumb
How the verdict is worked out
There is no official limit for a “good” mesh. The verdict uses these rules of thumb, in this order:
| Verdict | Rule | Why |
|---|---|---|
| Very flat | Range of 0.05 mm or less | Klipper’s probe guide treats a probe that repeats worse than 0.025 mm as too inaccurate for levelling. Twice that is about the smallest difference worth reading. |
| Tilt dominates | Tilt of at least 0.1 mm (or half a first layer, if larger) and more tilt than warp | Tilt can be removed at the hardware, so do that before asking the mesh to follow it. Klipper’s screw tool calls a bed level once every screw needs less than 6 minutes of a turn, which is 0.05 mm on an M3 thread. |
| Fine with mesh levelling | Range no more than one first layer (0.2 mm unless you change it) | Klipper’s bed mesh guide uses one layer height as the point where a mesh’s variation needs caution. |
| Usable, but worth improving | Range up to 2.5 first layers | The printer can follow it, but the first layers are stretched and squeezed to do so. |
| Too much for mesh levelling alone | Range over 2.5 first layers | Klipper’s guide notes that software correction only approximates the bed’s shape and cannot make up for mechanical problems. |
Treat these as a starting point. A large, thin bed will never be as flat as a small cast plate, and a 0.3 mm first layer forgives more than a 0.12 mm one.
Levelling by hand
How the screw estimate works
The tool fits a flat plane through the whole mesh and reads its height at each screw. The difference from the screw you leave alone, divided by the thread pitch, is the number of turns.
| Thread | Pitch (height per full turn) | A quarter turn moves the bed |
|---|---|---|
| M3 | 0.5 mm | 0.125 mm |
| M4 | 0.7 mm | 0.175 mm |
| M5 | 0.8 mm | 0.200 mm |
- It is an estimate. Springs, silicone spacers and a bed that flexes all change the result. Turn the screws, measure a new mesh and repeat.
- Measure the screw positions on your own bed. The starting values are only placeholders.
- If your mesh has no coordinates, the tool assumes it covers the whole bed. Meshes from a saved Klipper profile, UBL and RepRapFirmware carry their own coordinates.
- Direction: on most beds, turning a knob clockwise (seen from above) raises the bed and closes the gap to the nozzle. Check yours on one screw.
- No screws? Printers with a fixed bed or several Z motors level themselves; use the tilt figures to check that they did.
Formats
What the tool recognises
| Format | Recognised by | First row is |
|---|---|---|
| Klipper console output | “Mesh Leveling Probed Z positions” | The front of the bed |
| Klipper saved mesh | A points = line | The front |
| Marlin bilinear grid | “Bilinear Leveling Grid”, or numbered rows and columns | The front (row 0) |
| Marlin mesh bed levelling | “Measured points” with numbered rows | The front (row 0) |
| Marlin UBL | “Bed Topography Report” or corner coordinates in brackets | The back |
| Prusa G81 | “Measured points” without row numbers | The back |
| RepRapFirmware heightmap.csv | “RepRapFirmware height map” or its column names | The front |
| Plain grid | Rows with the same count of numbers | Taken as the front |
If the drawing is back to front compared with your bed, switch on “Flip front and back”. The numbers and statistics stay the same.
Questions, answered
Is my mesh uploaded?
No. The text is read and drawn in your browser. A share link carries the mesh inside the link itself, after the # sign, which browsers do not send to a server.
What is a good bed mesh range?
There is no official figure. As a rule of thumb, a range under one first layer (often 0.2 mm) is comfortable for mesh levelling, and under 0.05 mm is about as flat as a probe can measure.
Does mesh levelling fix a tilted bed?
It can follow a small tilt, but it is better to remove tilt at the hardware first. A mesh that follows a slope shifts every layer slightly, and it leaves less room to correct the real warp.
Why is my mesh different every time?
Heat and the probe. A bed changes shape as it warms, so measure at printing temperature after a few minutes of soaking. Differences of 0.02 to 0.03 mm between runs are within what many probes repeat.
The view is mirrored. What do I do?
Switch on “Flip front and back” or “Flip left and right”. Some firmware prints the back row first and some the front; the tool follows each firmware’s own order, but a plain grid cannot say which way round it is.
Can I print the surface?
Yes. “STL surface” saves the exaggerated surface as a solid, closed block with a flat base, at the mesh’s real width and depth when the mesh includes coordinates.
Is it free?
Yes. There is no account and no limit.
Sources
Print advice is a starting point drawn from these references, checked on 2026-11-11. Community posts are one maker's experience, not a specification.
- Bed Mesh Klipper documentation
- Probe calibration (probe repeatability) Klipper documentation
- Bed leveling: adjusting bed screws and screw tilt Klipper documentation
- Configuration reference: screws_tilt_adjust Klipper documentation
- M420 – Bed Leveling State Marlin
- G29 – Bed Leveling (Unified) Marlin
- Prusa firmware-specific G-code commands (G80, G81) Prusa Research
- G-code dictionary: G29 mesh bed probe Duet3D
- ISO 261: ISO general purpose metric screw threads, general plan ISO