---
tag: m0420
title: Bed Leveling State
brief: Get and/or set bed leveling state and parameters
author: thinkyhead
contrib: sustmi, shitcreek

requires: AUTO_BED_LEVELING_(3POINT|LINEAR|BILINEAR|UBL)|MESH_BED_LEVELING
group: motion

related: [ G29, M421 ]
codes: [ M420 ]

notes: |
  - [`G28`](/docs/gcode/G028.html) disables bed leveling. Follow with `M420 S` to turn leveling on, or use `RESTORE_LEVELING_AFTER_G28` to automatically keep leveling on after [`G28`](/docs/gcode/G028.html).
  - The "current position" may change in response to `M420 Sn`.

parameters:
  -
    tag: L
    optional: true
    description: Load mesh from EEPROM index (Requires `AUTO_BED_LEVELING_UBL` and `EEPROM_SETTINGS`)
    values:
      -
        type: int
  -
    tag: S
    optional: true
    description: Set enabled or disabled. A valid mesh is required to enable bed leveling. If the mesh is invalid / incomplete leveling will not be enabled.
    values:
      -
        type: bool
  -
    tag: V
    optional: true
    description: 'Verbose: Print the stored mesh / matrix data'
    values:
      -
        type: bool
  -
    tag: T
    optional: true
    description: Format to print the mesh data
    values:
      -
        tag: 0
        description: Human readable
      -
        tag: 1
        description: CSV
      -
        tag: 4
        description: Compact
  -
    tag: Z
    optional: true
    description: |
      Set Z fade height (Requires `ENABLE_LEVELING_FADE_HEIGHT`)
      - With Fade enabled, bed leveling correction is gradually reduced as the nozzle gets closer to the Fade height. Above the Fade height no bed leveling compensation is applied at all, so movement is machine true.
      - Set to 0 to disable fade, and leveling compensation will be fully applied to all layers of the print.
    values:
      -
        type: float
        tag: linear
  -
    tag: C
    optional: true
    description: Center the mesh on the mean of the lowest and highest points
    values:
      -
        type: bool

examples:

---

Get and/or set bed leveling state. For mesh-based leveling systems use `Z` parameter to set the Z Fade Height.

With `AUTO_BED_LEVELING_UBL` you can use `L` to load a mesh from EEPROM.