---
name: "formation"
type: command
status: ok
groups: ["Groups"]
arma3_since: "0.50"
locality: {"argument": "global", "effect": null, "server_exec": false}
source: https://community.bistudio.com/wiki/formation
revid: 379218
updated: 2026-10-30T22:28:40Z
---

# formation

*Command · Groups · Arma 3 v0.50 · introduced in Operation Flashpoint v1.00*

Locality: arguments **global**

## Description

Returns the current formation of a group.

## Syntax

```sqf
formation target
```

**Parameters:**

- `target`: [Object](../topics/Object.md), [Group](../topics/Group.md) or [Team Member](../topics/Team_Member.md)

**Returns:** [String](../topics/String.md) - can return:

- "COLUMN"
- "STAG COLUMN"
- "WEDGE"
- "ECH LEFT"
- "ECH RIGHT"
- "VEE"
- "LINE"
- "FILE"
- "DIAMOND"

## Examples

### Example 1

```sqf
if (formation group player == "wedge") then { hint "this is the default formation" };
```

## See also

[2D Editor: Waypoints](../topics/2D_Editor~3A_Waypoints.md) · [formLeader](../commands/formLeader.md) · [setFormation](../commands/setFormation.md)

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