> For the complete documentation index, see [llms.txt](https://manual.xlights.org/xlights/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://manual.xlights.org/xlights/effects/off/moving-head.md).

# Moving Head

### Position Tab

\
Grid: The grid can be used to quickly change the Pan and Tilt values. You will see the slider update as you move.\
Pan: This will pan all selected heads. This also works as an offset to any other commands like Fan and a Path.\
Tilt: This will tilt all selected heads. This also works as an offset to any other commands like Fan and a Path.\
Fan Pan: This sets the number of degrees to fan each head in the pan direction.\
Fan Tilt: This sets the number of degrees to fan each head in the tilt direction.\
Groupings: Divides the selected heads into groups of 1 through 6. So if you have 8 heads with a grouping of 2 then the first\
4 heads will fan and the second 4 heads will fan. Heads 1 and 5 will point the same direction and so on.\
Cycles: Change the motion speed of a head.\
Presets: Presets can be saved and an icon will be created to quickly recall those settings. It will try to draw a representation\
of the angle the heads are pointing and their colors.

<figure><img src="/files/NLTrSG6vxdhGDJFN3jdf" alt="" width="563"><figcaption></figcaption></figure>

### Pathing Tab

\
Draw paths the same way as the Sketch effect. I had to make some improvements to allow a path to close properly.\
Scale: You can draw a circle and then use the Scale slider to make the head move in a smaller or larger circle.\
Time Offset: This will stagger each selected head so they aren't all in the same position on the path.\
Ignore Pan: Ignores the pan part of the path\
Ignore Tilt: Ignores the tilt part of the path\
Presets: Presets can be saved and an icon is generated that can be clicked to quickly recall the path settings.

<figure><img src="/files/zmyWNhAndQW6bwyUXZI6" alt="" width="563"><figcaption></figcaption></figure>

### Control Tab

#### Color Tab

\
Click anywhere in the color circle to select a color for all selected heads.\
You can click and drag the circle around to change the color.\
If you Shift-Left click you can define additional circles and a number appears inside the circle.\
Multiple circles will cause the effect to do a colorwash through the selected colors.\
Click a circle and press the delete key to remove one.\
The color bar at the bottom can be used to dial down the brightness of the selected color.\
Control (Ctrl) click in the color circle to open the custom color picker for precise color entry.

<figure><img src="/files/RlWIfDuywkhRTLLh6KP4" alt="" width="563"><figcaption></figcaption></figure>

<figure><img src="/files/sOiwX9Am5iMaQRQpk0tS" alt="" width="563"><figcaption></figcaption></figure>

### Pattern Tab

The Pattern tab generates the pan and tilt movement from a parametric shape instead of a hand-drawn path. Pick a shape - such as Circle, Eight, Diamond, or Lissajous - and the effect automatically calculates the pan and tilt values needed for the selected heads to trace that shape.

The pattern can be rotated, and the rotation can be animated across the duration of the effect using a Value Curve, so the shape sweeps or spins as it plays.

<figure><img src="/files/BJALsE9vzmsS6Qp3T7MV" alt="" width="350"><figcaption></figcaption></figure>

### Gobo Tab

The Gobo tab is available when the moving head model has gobo support configured. In the model's properties you define a gobo channel, an optional gobo rotation channel, and named gobo slots for the fixture.

Use this tab to select which gobo is projected by the selected heads and to set the gobo rotation.

<figure><img src="/files/pt3lNQmVWPuiZv7XTv13" alt="" width="350"><figcaption></figcaption></figure>