---
name: "setFormationTask"
type: command
status: ok
groups: ["Unit Control"]
arma3_since: "0.50"
locality: {"argument": null, "effect": null, "server_exec": false}
source: https://community.bistudio.com/wiki/setFormationTask
revid: 379377
updated: 2026-10-30T23:58:24Z
---

# setFormationTask

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

## Description

Set the current task of the formation member.

> [!NOTE]
> This command is not available in Arma 2.

## Syntax

```sqf
unit setFormationTask task
```

**Parameters:**

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

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

## Examples

### Example 1

```sqf
_unit setFormationTask "MOVE";
```

## See also

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

## Community notes

**Donnervogel** — 2007-03-02

The argument for *task* can be any String value. This can effectively be used to store a property in String format an retrieve it with [formationTask](../commands/formationTask.md) in FSM scripts. By using it outside of FSM scripts you're risking to get it overwritten by other running FSM scripts.

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