---
name: "unitPos"
type: command
status: ok
groups: ["Unit Control"]
arma3_since: "0.50"
locality: {"argument": "global", "effect": null, "server_exec": false}
source: https://community.bistudio.com/wiki/unitPos
revid: 337059
updated: 2023-01-11T09:38:30Z
---

# unitPos

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

Locality: arguments **global**

## Description

Return the unit position rules.

The return value is always "Auto" unless the unit has gotten a [setUnitPos](../commands/setUnitPos.md) command. In that case the value is the last stance the unit was ordered to.

Available modes are listed at [setUnitPos](../commands/setUnitPos.md).

## Syntax

```sqf
unitPos unit
```

**Parameters:**

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

**Returns:** [String](../topics/String.md) - one of `"Auto"`, `"Up"`, `"Middle"`, `"Down"` (as of Arma 3)

## Examples

### Example 1

```sqf
hint str unitPos _unit;
```

## Multiplayer

Unit pos set by [setUnitPosWeak](../commands/setUnitPosWeak.md) is not returned for remote (non-local) units.

## See also

[setUnitPos](../commands/setUnitPos.md) · [setUnitPosWeak](../commands/setUnitPosWeak.md) · [stance](../commands/stance.md) · [pose](../commands/pose.md)

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