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

group: control
requires: NOZZLE_PARK_FEATURE, ADVANCED_PAUSE_FEATURE, FILAMENT_LOAD_UNLOAD_GCODES

codes: [ M701 ]
related: [ M600, M702 ]

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

example:
- 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.
