---
tag: m0701
title: Load filament
brief: Load filament
author: revilor

requires: NOZZLE_PARK_FEATURE,ADVANCED_PAUSE_FEATURE,FILAMENT_LOAD_UNLOAD_GCODES
group: control

codes: [ M701 ]

notes:
    - Enabled using [`FILAMENT_LOAD_UNLOAD_GCODES`](/docs/configuration/configuration.html#advanced-pause).
    - Uses the minimum temperature for safe extrusion as set by [`M302`](/docs/gcode/M302.html).
parameters:
  -
    tag: T
    optional: true
    description: Optional extruder index. Current extruder if omitted.
    values:
      -
        tag: extruder
        type: int
  -
    tag: Z
    optional: true
    description: Move the Z axis by this distance
    values:
      -
        tag: distance
        type: float
  -
    tag: L
    optional: false
    description: Extrude distance for insertion (positive value) (manual reload)
    values:
      -
        tag: distance
        type: float

examples:
  -
    pre: Load filament into the active extruder
    code: M701

---

Load filament into the active extruder. By default this will use the configured `ADVANCED_PAUSE_FEATURE` settings.