---
name: "formationPosition"
type: command
status: ok
groups: ["Positions"]
arma3_since: "0.50"
locality: {"argument": null, "effect": null, "server_exec": false}
source: https://community.bistudio.com/wiki/formationPosition
revid: 309288
updated: 2022-05-05T01:47:09Z
---

# formationPosition

*Command · Positions · Arma 3 v0.50 · introduced in Armed Assault v1.00*

## Description

Return position of unit in the formation.

## Syntax

```sqf
formationPosition unit
```

**Parameters:**

- `unit`: [Object](../topics/Object.md)

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

## Examples

### Example 1

```sqf
_pos = formationPosition _unit;
```

### Example 2

```sqf
// Reposition entire group to a new position (ground level)
private _group = group player;
private _leader = leader _group;

// Set the leader to the spawn position
_leader setPosATL markerPos "spawn_position";

// Reposition all units of the group except the leader
{
    private _formationPos = formationPosition _x;
    _formationPos set [2, 0];
    _x setPosATL _formationPos;
} forEach (units _group - [_leader]);
```

## See also

[formation](../commands/formation.md)

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