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

requires: NOZZLE_PARK_FEATURE,ADVANCED_PAUSE_FEATURE,FILAMENT_LOAD_UNLOAD_GCODES
group: control

codes: [ 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 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.