---
tag: g027
title: Park toolhead
brief: Park the current toolhead

experimental: true
since: 1.1.0
requires: NOZZLE_PARK_FEATURE
group: nozzle

codes: [ G27 ]

notes:
  - Requires `NOZZLE_PARK_FEATURE`.
  - The park position is defined by `NOZZLE_PARK_POINT`.

parameters:
  -
    tag: P
    optional: true
    description: 'Z axis action'
    values:
      -
        tag: 0
        description: If current Z-pos is lower than Z-park then the nozzle will be raised to reach Z-park height
      -
        tag: 1
        description: No matter the current Z-pos, the nozzle will be raised/lowered to reach Z-park height
      -
        tag: 2
        description: The nozzle height will be raised by Z-park amount but never going over the machine's limit of `Z_MAX_POS`

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

---

Park the nozzle at a predefined XYZ position.