---
name: "roleDescription"
type: command
status: ok
groups: ["Object Manipulation", "Multiplayer"]
arma3_since: "1.48"
locality: {"argument": null, "effect": null, "server_exec": false}
source: https://community.bistudio.com/wiki/roleDescription
revid: 329074
updated: 2022-07-21T23:46:21Z
---

# roleDescription

*Command · Object Manipulation, Multiplayer · Arma 3 v1.48*

## Description

Returns unit description set in the editor and visible on role selection screen in multiplayer.

## Syntax

```sqf
roleDescription unit
```

**Parameters:**

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

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

## Examples

### Example 1

```sqf
_playerRole = roleDescription player;
```

## Problems

**Does not** work in single player.

## See also

[name](../commands/name.md) · [getPlayerUID](../commands/getPlayerUID.md) · [vehicleVarName](../commands/vehicleVarName.md) · [worldName](../commands/worldName.md) · [briefingName](../commands/briefingName.md) · [missionName](../commands/missionName.md) · [serverName](../commands/serverName.md)

## Community notes

**Killzone_Kid** — 2015-06-29

One thing you should know about roles. When switching to units placed in editor on the fly in MP, it could mess up the role of the player. Could be bug, could be intended, but I would not recommend doing this. Create new unit dynamically if you need to switch to. Anyway, if role of the unit is messed up so is [roleDescription](../commands/roleDescription.md).

---

**Pierre MGI** — 2017-05-26

[roleDescription](../commands/roleDescription.md) works for playableUnits only. That means not on AI disabled in lobby and not in SP (even for player).

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