---
tag: g010
title: Retract
brief: Retract the filament
author: thinkyhead

group: motion
since: 1.0.0-beta
requires: FWRETRACT

codes: [ G10 ]
related: [ G11, M207, M208, M209 ]

parameters:

- tag: S
  optional: true
  requires: EXTRUDERS > 1
  description: Use `G10 S1` to do a swap retraction, before changing extruders. The subsequent [`G11`](/docs/gcode/G011.html) (after tool change) will do a swap recover.
  values:
  - type: bool

example:
- code: G10 ; retract

---

Retract the filament according to settings of [`M207`](/docs/gcode/M207.html).

Firmware retraction allows you to tune retraction at the machine level and can significantly reduce the size of G-code files.

Multiple consecutive `G10` or `G10 S1` commands without a corresponding [`G11`](/docs/gcode/G011.html) or `G11 S1` will be ignored.

Performs two moves: a retract move at the retract feedrate/acceleration, and an optional Z lift at the maximum Z feedrate (travel acceleration).
