---
tag: m0702
title: Unload filament
brief: Unload filament
author: revilor

group: control
requires: NOZZLE_PARK_FEATURE, ADVANCED_PAUSE_FEATURE, FILAMENT_LOAD_UNLOAD_GCODES

codes: [ M702 ]
related: [ M600, 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 number. If omitted, current extruder (or ALL extruders with [`FILAMENT_UNLOAD_ALL_EXTRUDERS`](/docs/configuration/configuration.html#advanced-pause)).
  values:
  - tag: extruder
    type: int

- tag: Z
  optional: true
  description: Move the Z axis by this distance
  values:
  - tag: distance
    type: float

- tag: U
  optional: false
  description: Retract distance for removal (manual reload)
  values:
  - tag: distance
    type: float

example:
- pre: Unload filament from current extruder
  code: M702

---

Unload filament. By default this command will use the configured `ADVANCED_PAUSE_FEATURE` settings.
