---
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: 348443
updated: 2023-11-08T13:00:16Z
---

# 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) or [Group](../topics/Group.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 · [formLeader](../commands/formLeader.md) · [setFormation](../commands/setFormation.md)

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