---
name: "BIS_fnc_loadInventory"
type: function
status: ok
groups: ["Inventory"]
arma3_since: "0.58"
locality: {"argument": null, "effect": null, "server_exec": false}
source: https://community.bistudio.com/wiki/BIS_fnc_loadInventory
revid: 349482
updated: 2023-11-08T17:09:03Z
---

# BIS_fnc_loadInventory

*Function · Inventory · Arma 3 v0.58*

## Description

Adds a predefined loadout (either via `CfgVehicles`, `CfgRespawnInventory`, or a custom inventory saved via [BIS_fnc_saveInventory](../functions/BIS_fnc_saveInventory.md)) to a specified unit.

## Syntax

```sqf
param call BIS_fnc_loadInventory
```

**Parameters:**

- [Object](../topics/Object.md) - unit to receive the loadout
- [Config](../topics/Config.md) or [Array](../topics/Array.md) - can be one of:
  - [Config](../topics/Config.md): config entry of loadout found in either `CfgVehicles` or `CfgRespawnInventory`
  - [Array](../topics/Array.md) in format [[Namespace](../topics/Namespace.md), [Group](../topics/Group.md) or [Object](../topics/Object.md), [String](../topics/String.md)] or [BIS_fnc_saveInventory](../functions/BIS_fnc_saveInventory.md)'s output
- [Array](../topics/Array.md) - (Optional, default `[]`) array of [String](../topics/String.md)s that define what part of the loadout to ignore, e.g ["weapons", "uniform"]

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

## Examples

### Example 1

```sqf
_loadout = [player, configFile >> "CfgVehicles" >> "B_Soldier_SL_F"] call BIS_fnc_loadInventory; // gives BLUFOR Squad Leader's loadout to player unit
```

### Example 2

to save and load the inventory:

```sqf
[player, [missionNamespace, "TAG_SavedInventory"]] call BIS_fnc_saveInventory;    // save it
[player, [missionNamespace, "TAG_SavedInventory"]] call BIS_fnc_loadInventory;    // load it
```

## See also

[BIS_fnc_saveInventory](../functions/BIS_fnc_saveInventory.md) · [BIS_fnc_exportInventory](../functions/BIS_fnc_exportInventory.md) · [BIS_fnc_deleteInventory](../functions/BIS_fnc_deleteInventory.md) · [setUnitLoadout](../commands/setUnitLoadout.md)

## Community notes

**Ilias38rus** — 2020-08-02

Doesn't work for backpacks in backpack, unlike [setUnitLoadout](../commands/setUnitLoadout.md).

<sub>Source: [BI Community Wiki — BIS fnc loadInventory](https://community.bistudio.com/wiki/BIS_fnc_loadInventory) (revision 349482).</sub>