Retract

Explicitly retracts filament by pulling it back from the nozzle. Pair with Unretract to prime before the next extrusion.

Block

Interactive preview is available in the interactive reader.

Parameters

distance (mm): How far to pull back filament. Typical: 0.5-2 mm (direct drive), 2-6 mm (Bowden).
speed (mm/s): Retraction speed. Typical: 25-50 mm/s.

How it works

Retract outputs G1 E-{distance} F{speed} to pull filament back from the nozzle. Use when you need manual control over retraction timing — for example, retracting before a custom G-code pause or when the engine's automatic retraction is not sufficient.

G-code output

Command	G-code
Retract	G1 E-{distance} F{speed}