---
name: "emptyPositions"
type: command
status: ok
groups: ["Object Manipulation", "Unit Control"]
arma3_since: "0.50"
locality: {"argument": null, "effect": null, "server_exec": false}
source: https://community.bistudio.com/wiki/emptyPositions
revid: 378582
updated: 2026-05-11T11:45:50Z
---

# emptyPositions

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

## Description

Returns the number of given empty positions in the vehicle.

> [!NOTE]
> To return the actual units in the vehicle use [fullCrew](../commands/fullCrew.md). However if only the number is desired, use [emptyPositions](../commands/emptyPositions.md) because it is faster.

## Syntax

### Syntax 1

```sqf
vehicle emptyPositions position
```

**Parameters:**

- `vehicle`: [Object](../topics/Object.md) - transport
- `position`: [String](../topics/String.md) - can be one of:
  - `"Commander"`
  - `"Driver"`
  - `"Gunner"`
  - `"Cargo"` - all cargo positions, FFV or not
  - Arma 3 v2.10 `""` - all empty positions
  - Arma 3 v2.10 `"CargoNoFFV"` - non-FFV cargo
  - Arma 3 v2.10 `"CargoFFV"` - FFV cargo
  - Arma 3 v2.14 `"Turret"` - empty turrets (no FFV turrets, they are included in "CargoFFV")

**Returns:** [Number](../topics/Number.md) - the number of available positions ignoring locked positions

### Syntax 2

*since arma3 2.22*

```sqf
vehicle emptyPositions [position, ignoreLocked]
```

**Parameters:**

- `vehicle`: [Object](../topics/Object.md) - transport
- `position`: [String](../topics/String.md) - see [moveInAny](../commands/moveInAny.md). Empty string "" returns number of all free positions
- `ignoreLocked (Optional)`: [Boolean](../topics/Boolean.md) - [true](../commands/true.md) to ignore locked positions. Default: [false](../commands/false.md)

**Returns:** [Number](../topics/Number.md) - the number of available positions ignoring locked positions

## Examples

### Example 1

```sqf
_freeCargoAndFFVPositions = vehicle player emptyPositions "Cargo";
```

### Example 2

```sqf
_freeCargoOnlyPositions = vehicle player emptyPositions "CargoNoFFV";
```

## See also

[moveInDriver](../commands/moveInDriver.md) · [moveInTurret](../commands/moveInTurret.md) · [moveInCommander](../commands/moveInCommander.md) · [moveInGunner](../commands/moveInGunner.md) · [moveInCargo](../commands/moveInCargo.md) · [getCargoIndex](../commands/getCargoIndex.md) · [moveInAny](../commands/moveInAny.md)

## Community notes

**DreadedEntity** — 2022-03-20

**emptyPositions** combines both turret and cargo in its output. If you must know the true count of either, you will have to use [fullCrew](../commands/fullCrew.md) (tested on several vehicles)

I have not found a way to test for copilot in helicopters

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