---
name: "BIS_fnc_getName"
type: function
status: ok
groups: ["Object Manipulation"]
arma3_since: "1.00"
locality: {"argument": null, "effect": null, "server_exec": false}
source: https://community.bistudio.com/wiki/BIS_fnc_getName
revid: 378438
updated: 2026-04-12T00:54:47Z
---

# BIS_fnc_getName

*Function · Object Manipulation · Arma 3 v1.00*

## Description

Returns name of a unit. Name of unit is stored in it is namespace so it can be retrieved later, mainly for when unit dies. Name is stored in the variable **BIS_fnc_getName_name**.

If the unit is alive, this function does [name](../commands/name.md) and returns the result, and saves the result to the variable on the unit. If the unit is dead, the function tries to retrieve the saved name from the variable on the unit, and returns "" if none is saved, unless forcedWhenDead is set to [true](../commands/true.md).

## Syntax

```sqf
[object] call BIS_fnc_getName
```

**Parameters:**

- `object`: [Object](../topics/Object.md) - object whose name should be returned
- `forcedWhenDead`: [Boolean](../topics/Boolean.md) - (Optional, default [false](../commands/false.md)) forces the function to do [name](../commands/name.md) on the unit if it's dead and has no name saved in the variable. Might have inconsistent results.
- `maxCharacters`: [Number](../topics/Number.md) - (Optional, default -1) the name returned will be limited to this length. -1 for no limit. The name saved to the variable is not limited.

**Returns:** [String](../topics/String.md) - unit's name

## Examples

### Example 1

```sqf
[player] call BIS_fnc_getName;
```

## See also

[name](../commands/name.md)

<sub>Source: [BI Community Wiki — BIS fnc getName](https://community.bistudio.com/wiki/BIS_fnc_getName) (revision 378438).</sub>