Items Documentation - minecraft:storage_item

Enables an item to store data of the dynamic container associated with it. A dynamic container is a container for storing items that is linked to an item instead of a block or an entity.

Note

While this component can be defined on its own, to be able to interact with the item's storage container the item must have a minecraft:bundle_interaction item component defined.

Note

Available without experimental toggle in 1.21.110.

Note

In 1.26.0, equipping an item with this component into an armor or hand slot no longer deletes the storage contents.

Note

This item requires a format version of at least 1.21.40.

Item Storage Item Properties

Name	Default Value	Type	Description	Example Values
allow_nested_storage_items	true	Boolean true/false	Determines whether another Storage Item is allowed inside of this item. Default is true.	Black Bundle: true
allowed_items	[]	String	List of items that are exclusively allowed in this Storage Item. If empty all items are allowed.
allowed_items (as Keyed set of strings)	not set	Keyed set of strings
banned_items	[]	String	List of items that are not allowed in this Storage Item.	Black Bundle: ["minecraft:shulker_box","minecraft:undyed_shulker_box"]
banned_items (as Keyed set of strings)	not set	Keyed set of strings
max_slots	64	Integer number	The maximum allowed weight of the sum of all contained items. Maximum is 64. Default is 64. Value must be <= 64.	Black Bundle: 64

Samples

Black Bundle

"minecraft:storage_item": {
  "max_slots": 64,
  "allow_nested_storage_items": true,
  "banned_items": [
    "minecraft:shulker_box",
    "minecraft:undyed_shulker_box"
  ]
}