---
name: "setGroupId"
type: command
status: ok
groups: ["Groups"]
arma3_since: "0.50"
locality: {"argument": "global", "effect": "local", "server_exec": false}
source: https://community.bistudio.com/wiki/setGroupId
revid: 376660
updated: 2025-11-03T17:32:23Z
---

# setGroupId

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

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

## Description

Sets the group radio callsign, how it will be displayed in radio chat. Two groups on the same side **cannot** have the same callsign (possible on different sides) - see [#Example 4](../commands/setGroupId.md#example-4).

The identity setup can consist of format keywords (marked with **%**) and param keywords taken from **CfgWorlds** config.
Formatting is almost like using the [format](../commands/format.md) command but with some special group keywords (see [#Example 2](../commands/setGroupId.md#example-2)).

| %GroupSquad | %GroupPlatoon | %GroupCompany | %GroupNames | %GroupColors |
|---|---|---|---|---|
| - "Squad1" → 1<br>- "Squad2" → 2<br>- "Squad3" → 3<br>- "Squad4" → 4 | - "Platoon1" → 1<br>- "Platoon2" → 2<br>- "Platoon3" → 3<br>- "Platoon4" → 4 | - "CompanyAlpha" → Alpha<br>- "CompanyBravo" → Bravo<br>- "CompanyCharlie" → etc.<br>- "CompanyDelta"<br>- "CompanyEcho"<br>- "CompanyFoxtrot"<br>- "CompanyGolf"<br>- "CompanyHotel"<br>- "CompanyIndia"<br>- "CompanyKilo"<br>- "CompanyLima"<br>- "CompanyMike"<br>- "CompanyNovember"<br>- "CompanyOscar"<br>- "CompanyPapa"<br>- "CompanyQuebec"<br>- "CompanyRomeo"<br>- "CompanySierra"<br>- "CompanyTango"<br>- "CompanyUniform"<br>- "CompanyVictor"<br>- "CompanyWhiskey"<br>- "CompanyXray" → X-Ray<br>- "CompanyYankee"<br>- "CompanyZulu" | - "Alpha"<br>- "Bravo"<br>- "Charlie"<br>- "Delta"<br>- "Echo"<br>- "Foxtrot"<br>- "Golf"<br>- "Hotel"<br>- "November"<br>- "Kilo"<br>- "Yankee"<br>- "Zulu"<br>- "Convoy"<br>- "Buffalo"<br>- "Guardian"<br>- "Two"<br>- "Three"<br>- "Fox" | - "GroupColor0" → (nothing)<br>- "GroupColor1" → Black<br>- "GroupColor2" → Red<br>- "GroupColor3" → Green<br>- "GroupColor4" → Blue<br>- "GroupColor5" → Yellow<br>- "GroupColor6" → Orange<br>- "GroupColor7" → Pink<br>- "Six" → Six |

| Letter | Colour |
|---|---|
| - "Alpha"<br>- "Bravo"<br>- "Charlie"<br>- "Delta"<br>- "Echo"<br>- "Foxtrot"<br>- "Golf"<br>- "Hotel"<br>- "Kilo"<br>- "Yankee"<br>- "Zulu"<br>- "Buffalo"<br>- "Convoy"<br>- "Guardian"<br>- "November"<br>- "Two"<br>- "Three"<br>- "Fox" | - "GroupColor0" → (nothing)<br>- "GroupColor1" → Black<br>- "GroupColor2" → Red<br>- "GroupColor3" → Green<br>- "GroupColor4" → Blue<br>- "GroupColor5" → Yellow<br>- "GroupColor6" → Orange<br>- "GroupColor7" → Pink<br>- "Six" → Six |

> [!NOTE]
> **Operation Flashpoint:** - In **Operation Flashpoint**, the group ID cannot be freely decided and format must be [letter, colour, picture] or [letter, colour] - *nameFormat* **cannot** be a custom text - see [#Example 3](../commands/setGroupId.md#example-3).
> - The radio callsign strings can be overwritten in a mission by writing Stringtable entries of the same name. Some entry names:
> - STR_CFG_*GRPNAMES*_**ALPHA**
> - STR_CFG_*GRPNAMES*_**FOX**
> - STR_CFG_*GRPCOL*_**BLACK**
> - STR_CFG_*GRPNAMES*_**SIX** (unlike its name suggests, this is a "group colour")
> - STR_CFG_FIREFLYBASE
> - STR_CFG_PAPABEAR
> - STR_CFG_HQ_BASE

## Syntax

```sqf
group setGroupId [nameFormat, nameParam1, nameParam2, ...]
```

**Parameters:**

- `group`: [Object](../topics/Object.md) or [Group](../topics/Group.md)
- `nameFormat`: [String](../topics/String.md) - format template (%keyword1 - %keyword2...etc)
- `nameParamN`: [String](../topics/String.md) - param keyword

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

## Examples

### Example 1

**Arma 3**:

```sqf
group player setGroupId ["Some name for the group"];
hint groupId group player;    // "Some name for the group"
player sideChat "lalala";    // Some name for the group (KK): "lalala"
```

### Example 2

**Arma 3**:

```sqf
group player setGroupId ["%GroupNames :=: %GroupColors", "Alpha", "GroupColor2"];
hint groupId group player;    // "Alpha :=: Red"
player sideChat "lalala";    // Alpha :=: Red (KK): "lalala"
```

### Example 3

**Armed Assault / Arma 2 / Arma 3**:

```sqf
group player setGroupId ["First Assault Recon Team"];
```

**Operation Flashpoint**:

```sqf
_group1 setGroupId ["Delta", "GroupColor4"]
```

### Example 4

When trying to apply the same callsign to two groups of the same side, the callsigns will simply be swapped, e.g:

```sqf
group1 setGroupId ["Active Group"];
group2 setGroupId ["Inactive Group"];
group2 setGroupId ["Active Group"]; // group1 is "Inactive Group" now
```

## Multiplayer

For the global variant of this command see [setGroupIdGlobal](../commands/setGroupIdGlobal.md).

## See also

[setGroupIdGlobal](../commands/setGroupIdGlobal.md) · [groupId](../commands/groupId.md) · [group](../commands/group.md)

## Community notes

**Killzone_Kid** — 2015-04-21

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