---
name: "formationTask"
type: command
status: ok
groups: ["Groups"]
arma3_since: "0.50"
locality: {"argument": null, "effect": null, "server_exec": false}
source: https://community.bistudio.com/wiki/formationTask
revid: 310864
updated: 2022-05-07T20:24:09Z
---

# formationTask

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

## Description

Return the current task of the unit in the formation.

## Syntax

```sqf
formationTask unit
```

**Parameters:**

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

**Returns:** [String](../topics/String.md): "EXCLUDED", "MOVE", "COVER", "LEADER", "NOTHING"

## Examples

### Example 1

```sqf
_currentTask = formationTask _unit;
```

## See also

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

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