---
name: "rank"
type: command
status: ok
groups: ["Unit Identity"]
arma3_since: "0.50"
locality: {"argument": "global", "effect": null, "server_exec": false}
source: https://community.bistudio.com/wiki/rank
revid: 337318
updated: 2023-01-16T09:46:20Z
---

# rank

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

Locality: arguments **global**

## Description

Returns the rank of the given unit. Rank can be one of the following:
- `"PRIVATE"`
- `"CORPORAL"`
- `"SERGEANT"`
- `"LIEUTENANT"`
- `"CAPTAIN"`
- `"MAJOR"`
- `"COLONEL"`

## Syntax

```sqf
rank unit
```

**Parameters:**

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

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

## Examples

### Example 1

```sqf
_rank = rank player;
```

## See also

[rankId](../commands/rankId.md) · [rating](../commands/rating.md) · [addRating](../commands/addRating.md) · [setUnitRank](../commands/setUnitRank.md) · ArmA: Rating Values

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