---
name: "setWaypointFormation"
type: command
status: ok
groups: ["Waypoints"]
arma3_since: "0.50"
locality: {"argument": null, "effect": "global", "server_exec": true}
source: https://community.bistudio.com/wiki/setWaypointFormation
revid: 377761
updated: 2026-01-03T00:58:21Z
---

# setWaypointFormation

*Command · Waypoints · Arma 3 v0.50 · introduced in Operation Flashpoint: Elite v1.00*

Locality: effect **global** · **server execution only**

## Description

Switches the group formation when the waypoint becomes active.

Possible values are:
- "NO CHANGE"
- "COLUMN"
- "STAG COLUMN"
- "WEDGE"
- "ECH LEFT"
- "ECH RIGHT"
- "VEE"
- "LINE"
- "FILE"
- "DIAMOND"

## Syntax

```sqf
waypoint setWaypointFormation formation
```

**Parameters:**

- `waypoint`: Waypoint
- `formation`: [String](../topics/String.md)

**Returns:** [Nothing](../topics/Nothing.md)

## Examples

### Example 1

```sqf
[_grp, 2] setWaypointFormation "LINE";
```

## See also

Mission Editor: Waypoints · [waypoints](../commands/waypoints.md) · [deleteWaypoint](../commands/deleteWaypoint.md) · [copyWaypoints](../commands/copyWaypoints.md) · [setCurrentWaypoint](../commands/setCurrentWaypoint.md) · [setWaypointBehaviour](../commands/setWaypointBehaviour.md) · [setWaypointCombatMode](../commands/setWaypointCombatMode.md) · [setWaypointCompletionRadius](../commands/setWaypointCompletionRadius.md) · [setWaypointDescription](../commands/setWaypointDescription.md) · [setWaypointHousePosition](../commands/setWaypointHousePosition.md) · [setWaypointPosition](../commands/setWaypointPosition.md) · [setWaypointScript](../commands/setWaypointScript.md) · [setWaypointSpeed](../commands/setWaypointSpeed.md) · [setWaypointStatements](../commands/setWaypointStatements.md) · [setWaypointTimeout](../commands/setWaypointTimeout.md) · [setWaypointType](../commands/setWaypointType.md) · [setWaypointVisible](../commands/setWaypointVisible.md) · [waypointAttachVehicle](../commands/waypointAttachVehicle.md) · [waypointAttachedVehicle](../commands/waypointAttachedVehicle.md) · [setWaypointLoiterRadius](../commands/setWaypointLoiterRadius.md) · [waypointLoiterRadius](../commands/waypointLoiterRadius.md) · [addWaypoint](../commands/addWaypoint.md) · [setWaypointLoiterType](../commands/setWaypointLoiterType.md) · [waypointSpeed](../commands/waypointSpeed.md)

<sub>Source: [BI Community Wiki — setWaypointFormation](https://community.bistudio.com/wiki/setWaypointFormation) (revision 377761).</sub>