---
name: "removeWeaponItem"
type: command
status: ok
groups: ["Unit Inventory"]
arma3_since: "2.22"
locality: {"argument": "local", "effect": "global", "server_exec": false}
source: https://community.bistudio.com/wiki/removeWeaponItem
revid: 376149
updated: 2025-09-06T17:37:00Z
---

# removeWeaponItem

*Command · Unit Inventory · Arma 3 v2.22*

Locality: arguments **local** · effect **global**

## Description

Removes magazine from the specified muzzle.
It is possible to remove magazine directly from 'Throw' muzzle provided it is configured with `keepInInventory = 0;`.

> [!NOTE]
> To add such magazine, see [addWeaponItem](../commands/addWeaponItem.md).

## Syntax

```sqf
unit removeWeaponItem [muzzle, magazine]
```

**Parameters:**

- `unit`: [Object](../topics/Object.md)
- `muzzle`: [String](../topics/String.md) - name of the muzzle to add magazine to
- `magazine`: [String](../topics/String.md) - class name of the magazine to remove

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

## Examples

### Example 1

```sqf
player removeWeaponItem ["arifle_MX_GL_ACO_F", "1Rnd_HE_Grenade_shell"];
```

## See also

[addWeaponItem](../commands/addWeaponItem.md) · [addPrimaryWeaponItem](../commands/addPrimaryWeaponItem.md) · [addSecondaryWeaponItem](../commands/addSecondaryWeaponItem.md) · [addHandgunItem](../commands/addHandgunItem.md) · [addBinocularItem](../commands/addBinocularItem.md) · [weaponsItems](../commands/weaponsItems.md) · [handgunItems](../commands/handgunItems.md) · [primaryWeaponItems](../commands/primaryWeaponItems.md) · [secondaryWeaponItems](../commands/secondaryWeaponItems.md) · [binocularItems](../commands/binocularItems.md) · [removePrimaryWeaponItem](../commands/removePrimaryWeaponItem.md) · [removeSecondaryWeaponItem](../commands/removeSecondaryWeaponItem.md) · [removeHandgunItem](../commands/removeHandgunItem.md) · [removeBinocularItem](../commands/removeBinocularItem.md)

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