---
tag: g027
title: Park toolhead
brief: Park the current toolhead
author: jbrazio
contrib: thinkyhead

group: nozzle
since: 1.1.0
requires: NOZZLE_PARK_FEATURE

codes: [ G27 ]

notes:
- The parking XY position and Z value are defined by `NOZZLE_PARK_POINT`.
- The minimum Z raise is defined by `NOZZLE_PARK_Z_RAISE_MIN`.

parameters:
- tag: P
  since: 2.0.0
  optional: true
  description: Parking behavior
  values:
  - tag: 0
    description: (Default) Relative raise by `NOZZLE_PARK_Z_RAISE_MIN` before XY parking. In this case `NOZZLE_PARK_POINT.z` is used as the _minimum_ Z park position.
  - tag: 1
    description: Absolute move to `NOZZLE_PARK_POINT.z` before XY parking. _This may move the nozzle down, so use with caution!_
  - tag: 2
    description: Relative raise by `NOZZLE_PARK_POINT.z` before XY parking.
  - tag: 3
    since: 2.1.3
    description: Relative raise by `NOZZLE_PARK_Z_RAISE_MIN`, skip XY parking.
  - tag: 4
    since: 2.1.3
    description: No Z raise. Just XY parking.

examples:
- pre: The most basic example is to use the command without any arguments, which raises Z by the default distance and moves to the parking position.
  code: G27 ; Raise Z if lower

- pre: This one is useful as an end script, simply raising Z and parking.
  code: G27 P2 ; Always raise Z

---

Raise and park the nozzle according to a predefined XY position and Z raise (or minimum height) value.
