---
name: "getUserInfo"
type: command
status: ok
groups: ["Multiplayer", "Object Detection"]
arma3_since: "2.06"
locality: {"argument": null, "effect": null, "server_exec": true}
source: https://community.bistudio.com/wiki/getUserInfo
revid: 378191
updated: 2026-03-10T18:34:18Z
---

# getUserInfo

*Command · Multiplayer, Object Detection · Arma 3 v2.06*

Locality: **server execution only**

## Description

Returns extended information about given server user.

## Syntax

### Syntax 1

```sqf
getUserInfo playerID
```

**Parameters:**

- `playerID`: [String](../topics/String.md) - user DirectPlay ID (see [getPlayerID](../commands/getPlayerID.md), [PlayerConnected](../topics/Mission_Event_Handlers.md#playerconnected))

**Returns:** [Array](../topics/Array.md) with [playerID, owner, playerUID, soldierName, displayName, steamProfileName, clientStateNumber, isHeadless, adminState, networkInfo, playerObject]
- 0 - playerID: [String](../topics/String.md) - user DirectPlay ID (see [getPlayerID](../commands/getPlayerID.md), [PlayerConnected](../topics/Mission_Event_Handlers.md#playerconnected))
- 1 - owner: [Number](../topics/Number.md) - user owner (see [owner](../commands/owner.md))
- 2 - playerUID: [String](../topics/String.md) - player UID (see [getPlayerUID](../commands/getPlayerUID.md))
- 3 - soldierName: [String](../topics/String.md) - player name (see [profileName](../commands/profileName.md))
- 4 - displayName: [String](../topics/String.md) - player name including squad (see [name](../commands/name.md), [squadParams](../commands/squadParams.md))
- 5 - steamProfileName: [String](../topics/String.md) - returns the *current machine's* Steam profile name (see [profileNameSteam](../commands/profileNameSteam.md)), **not** the targeted player's Steam profile name
- 6 - clientStateNumber: [String](../topics/String.md) user client state (see [getClientStateNumber](../commands/getClientStateNumber.md))
- 7 - isHeadless: [Boolean](../topics/Boolean.md) - whether or not this is a headless client (see [hasInterface](../commands/hasInterface.md), [isServer](../commands/isServer.md))
- 8 - adminState: [Number](../topics/Number.md) - admin status of the user (see [admin](../commands/admin.md))
- 9 - networkInfo: [Array](../topics/Array.md) of [Number](../topics/Number.md)s - format [ping, bandwidth, desync]
- 10 - playerObject: [Object](../topics/Object.md) - user player entity (see [player](../commands/player.md), [selectPlayer](../commands/selectPlayer.md))

> [!NOTE]
> Returns an empty array if said player is not found.

### Syntax 2

*since Arma3 2.18*

```sqf
playerID getUserInfo infoIndex
```

**Parameters:**

- `playerID`: [String](../topics/String.md) - user DirectPlay ID (see [getPlayerID](../commands/getPlayerID.md), [PlayerConnected](../topics/Mission_Event_Handlers.md#playerconnected))
- `infoIndex`: [Number](../topics/Number.md) - the index of the data in the return array (see main syntax)

**Returns:** [Anything](../topics/Anything.md) - depends on the requested index (see main syntax) or [Nothing](../topics/Nothing.md)

## Examples

### Example 1

```sqf
private _randomUserInfo = getUserInfo selectRandom allUsers;
```

### Example 2

```sqf
_userInfo params ["_playerID", "_ownerId", "_playerUID", "_profileName", "_displayName", "_steamName", "_clientState", "_isHC", "_adminState", "_networkInfo", "_unit"];
_networkInfo params ["_avgPing", "_avgBandwidth", "_desync"];
```

### Example 3

```sqf
private _myInfo = getUserInfo getPlayerID player; // this particular example only works if player is server host
```

## See also

[allUsers](../commands/allUsers.md) · [getPlayerID](../commands/getPlayerID.md) · [getUnitFreefallInfo](../commands/getUnitFreefallInfo.md)

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