---
name: "setUnitPos"
type: command
status: ok
groups: ["Unit Control"]
arma3_since: "0.50"
locality: {"argument": "local", "effect": "global", "server_exec": false}
source: https://community.bistudio.com/wiki/setUnitPos
revid: 379470
updated: 2026-10-31T00:10:48Z
---

# setUnitPos

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

Locality: arguments **local** · effect **global**

## Description

Set unit position rules. This command will not change the stance of the human player, even though it will change the output of [unitPos](../commands/unitPos.md) command. To change player stance use [playAction](../commands/playAction.md) or [playActionNow](../commands/playActionNow.md):

```sqf
player playAction "PlayerProne"; // DOWN
player playAction "PlayerStand"; // UP
player playAction "PlayerCrouch"; // MIDDLE
```

## Syntax

```sqf
unit setUnitPos mode
```

**Parameters:**

- `unit`: [Object](../topics/Object.md)
- `mode`: [String](../topics/String.md) - can be:

  - "DOWN" - Unit goes prone and stays prone.
  - "UP" - Unit stands and stays standing.
  - "MIDDLE" - Kneel Position. Armed Assault v1.04 - Unit will not kneel if it is unarmed
  - "AUTO" - Unit chooses mode according to circumstances.

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

## Examples

### Example 1

```sqf
_soldier setUnitPos "UP";
```

## See also

[setUnitPosWeak](../commands/setUnitPosWeak.md) · [unitPos](../commands/unitPos.md)

## Community notes

**Dwarden** — 2008-09-18

Command most likely only works if run before [join](../commands/join.md) into group after [createUnit](../commands/createUnit.md).

---

**.kju** — 2011-03-11

The above comment by Dwarden about 'an additional join required' is no longer true for Operation Arrowhead.

---

**Katulobotomia** — 2013-09-26

A unit might not always go prone when ordered to [setUnitPos](../commands/setUnitPos.md) "DOWN", if the unit doesn't agree with the command. To force the unit to go prone, stop the unit from firing by [setCombatMode](../commands/setCombatMode.md) "BLUE" and then order the unit to prone.

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