---
name: "join"
type: command
status: ok
groups: ["Groups"]
arma3_since: "0.50"
locality: {"argument": "global", "effect": "global", "server_exec": false}
source: https://community.bistudio.com/wiki/join
revid: 377820
updated: 2026-01-03T04:19:29Z
---

# join

*Command · Groups · Arma 3 v0.50 · introduced in Operation Flashpoint v1.34*

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

## Description

| Maximum number of<br>units per group |  |
|---|---|
| Operation Flashpoint | 12 |
| Later titles | 10000+ |

Joins units into a given [Group](../topics/Group.md).

To make a unit leave its current group, join it into [grpNull](../commands/grpNull.md) (e.g. `[MyUnit] join grpNull`) - but beware: A new group is created for the leaving unit; this could result in the number of groups growing out of control.

## Syntax

```sqf
unitArray join group
```

**Parameters:**

- `unitArray`: [Array](../topics/Array.md) of Objects - units to join group
- `group`: [Group](../topics/Group.md) or [Object](../topics/Object.md)

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

## Examples

### Example 1

```sqf
[_unitOne, _unitTwo] join player;
```

### Example 2

```sqf
[_unitOne, _unitTwo] join (group player);
```

## See also

[joinAs](../commands/joinAs.md) · [joinAsSilent](../commands/joinAsSilent.md) · [joinSilent](../commands/joinSilent.md) · [group](../commands/group.md) · [leader](../commands/leader.md) · [doFollow](../commands/doFollow.md)

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