/item

For the Bedrock Edition equivalent, see Commands/replaceitem.

This feature is exclusive to Java Edition.

 

This article needs to be updated.

 

Please update this article to reflect recent updates or newly available information. The talk page may contain suggestions.
Reason: /item fill in 26.3

Manipulate or copy items in the inventories of blocks (chests, furnaces, etc.) or entities (players or mobs).

item modify (block <pos>|entity <targets>) <slot> <modifier>

Modifies the items in the specified slot with the specified item modifier.

item replace (block <pos>|entity <targets>) <slot> with <item> [<count>]

Replaces the items in the specified slot with the specified items.

item replace (block <pos>|entity <targets>) <slot> from (block <sourcePos>|entity <sourceTarget>) <sourceSlot> [<modifier>]

Copies the source items to the target slot and optionally modifies it with the modifier.

item override (block <pos>|entity <targets>) <slot> with <item> [<count>]

item override (block <pos>|entity <targets>) <slot> from (block <sourcePos>|entity <sourceTarget>) <sourceSlot> [<modifier>]

Appears to have same functionality as item replace equivalent.​^{[more information needed]}​^{[upcoming: JE 26.3]}

item fill (block <pos>|entity <targets>) <slots> with <item> [<count>]

item fill (block <pos>|entity <targets>) <slots> from (block <sourcePos>|entity <sourceTarget>) <sourceSlots> [<modifier>]

Similar to item replace, but can fill items across multiple slots. See § Arguments and Slot for more details.

Syntax displayed in various ways

Simplified tree:
item ... ... modify <TARGET> <slot> <modifier> ... replace <TARGET> <slot> ... override <TARGET> <slots> ... with <item> [<count>] ... from <SOURCE> <sourceSlot> [<modifier>] ... fill <TARGET> <slots> ... with <item> [<count>] ... from <SOURCE> <sourceSlots> [<modifier>] where substituted arguments are: <TARGET> = (block <pos>|entity <targets>) <SOURCE> = (block <sourcePos>|entity <sourceTarget>)

Minimised:
item (modify (block <pos>|entity <targets>) <slot> <modifier>|(replace|override) (block <pos>|entity <targets>) <slot> (with <item> [<count>]|from (block <sourcePos>|entity <sourceTarget>) <sourceSlot> [<modifier>])|fill (block <pos>|entity <targets>) <slots> (with <item> [<count>]|from (block <sourcePos>|entity <sourceTarget>) <sourceSlots> [<modifier>]))

Maximised:

item modify block <pos> <slot> <modifier> item modify entity <targets> <slot> <modifier> item replace block <pos> <slot> with <item> [<count>] item replace block <pos> <slot> from block <sourcePos> <sourceSlot> [<modifier>] item replace block <pos> <slot> from entity <sourceTarget> <sourceSlot> [<modifier>] item replace entity <targets> <slot> with <item> [<count>] item replace entity <targets> <slot> from block <sourcePos> <sourceSlot> [<modifier>] item replace entity <targets> <slot> from entity <sourceTarget> <sourceSlot> [<modifier>] item override block <pos> <slot> with <item> [<count>] item override block <pos> <slot> from block <sourcePos> <sourceSlot> [<modifier>] item override block <pos> <slot> from entity <sourceTarget> <sourceSlot> [<modifier>] item override entity <targets> <slot> with <item> [<count>] item override entity <targets> <slot> from block <sourcePos> <sourceSlot> [<modifier>] item override entity <targets> <slot> from entity <sourceTarget> <sourceSlot> [<modifier>] item fill block <pos> <slots> with <item> [<count>] item fill block <pos> <slots> from block <sourcePos> <sourceSlots> [<modifier>] item fill block <pos> <slots> from entity <sourceTarget> <sourceSlots> [<modifier>] item fill entity <targets> <slots> with <item> [<count>] item fill entity <targets> <slots> from block <sourcePos> <sourceSlots> [<modifier>] item fill entity <targets> <slots> from entity <sourceTarget> <sourceSlots> [<modifier>]

<pos>: block_pos

Specifies the position of the block to be modified.

Must be a block position composed of <X>, <Y> and <Z>, each of which must be an integer or a tilde and caret notation.

<targets>: entity

Specifies one or more entities to modify.

Must be a player name, a target selector or a UUID.

<slot>: item_slot

Specifies the inventory slot to be modified. Valid values depend on whether a block or an entity is being modified.

Must be a string notation that refer to a single slot in the inventory, which consists of "slot type" and optional "slot number", in the format of <slot_type> or <slot_type>.<slot_number>. See Slot for details.

<slots>: item_slots

Similar to <slot>, but can contain multiple slots.

Must be a string notation or slot source that refer to certain slot(s) in the inventory. The string notation consists of "slot type" and optional "slot number", in the format of <slot_type> or <slot_type>.<slot_number>. Wildcard (*) is accepted. See Slot for details.

<modifier>: loot_modifier

Specifies the item modifier to apply on the chosen item.

Specifies a item modifier with a resource location or in SNBT format. Must be a valid item modifier definition in SNBT format, or a resource location of an existing item modifier (an entry in minecraft:item_modifier registry). For NBT tag, if it is a string tag, the tag is also parsed into a resource location and resolved into an existing item modifier; otherwise, the tag is parsed as a new item modifier definition.

<item>: item_stack

Specifies the item to be placed in the block or entity's inventory slot.

It must be in the format of item_id[data_components], in which [data_components] can be omitted when they are not needed. See minecraft:item_stack for details.

<count>: integer

Specifies the number of items to be placed in the block or entity's inventory slot.

Must be a [Int]32-bit integer number (from -2147483648 (-2³¹) to 2147483647 (2³¹-1) ). And it must be between 1 and 99 (inclusive).

<sourcePos>: block_pos

Specifies the position of the block to copy items from.

Must be a block position composed of <X>, <Y> and <Z>, each of which must be an integer or a tilde and caret notation.

<sourceTarget>: entity

Specifies an entity to copy items from.

Must be a player name, a target selector or a UUID.

<sourceSlot>: item_slot

Specifies the inventory slot to copy the items from. Valid values depend on whether the source is block or an entity.

Must be a string notation that refer to a single slot in the inventory, which consists of "slot type" and optional "slot number", in the format of <slot_type> or <slot_type>.<slot_number>. See Slot for details.

<sourceSlots>: item_slots

Similar to <sourceSlot>, but can contain multiple slots.

Must be a string notation or slot source that refer to certain slot(s) in the inventory. The string notation consists of "slot type" and optional "slot number", in the format of <slot_type> or <slot_type>.<slot_number>. Wildcard (*) is accepted. See Slot for details.

• To replace the items in the bottom-right slot of a single chest two block above with four spruce saplings:
  • /item replace block ~ ~2 ~ container.26 with minecraft:spruce_sapling 4
• To replace the items in the rightmost hotbar slot of the nearest player with four spruce saplings:
  • /item replace entity @p hotbar.8 with minecraft:spruce_sapling 4
• To replace the item in the offhand of the selected player with the item in their main hand:
  • /item replace entity @s weapon.offhand from entity @s weapon.mainhand
• To put a brown banner on a player's head
  • /item replace entity @s armor.head with minecraft:brown_banner
• To increase the count of the item in your main hand:
  • /item modify entity @s weapon.mainhand example:increase_count
  • file in a data pack: data/example/item_modifier/increase_count.json

    {
      "function": "minecraft:set_count",
      "count": 1,
      "add": true
    }
    

• To increase the count of the item in your main hand without external files:
  • item modify entity @s weapon.mainhand {"function":"minecraft:set_count","count":1,"add":true}
• To put the item in your hand, on your head:
  • /item replace entity @s armor.head from entity @s weapon.mainhand

• /data — can also replace items in a container's or mob's inventory, or modify the drop chances of armor and weapons
• /give — give items to players without specifying specific inventory slots or overwriting other items
• /replaceitem — The Bedrock Edition equivalent