A bundle is an item that can store up to a stack's worth of mixed item types within itself in a single inventory slot. Items can be individually selected and taken out of the bundle via the inventory menu.
Dyed bundles are the dyed variants of bundles.
Obtaining
Crafting
Generated loot
| Item | Structure | Container | Quantity | Chance |
|---|---|---|---|---|
| Java Edition and Bedrock Edition | ||||
| Common chest | 1 | 27.5%{ "item": "Bundle", "stacksize": 1, "chance": 0.2747977375984192, "structure": "Abandoned Camp", "container": "Common chest" }
| ||
| Barrel | 1 | 33.3%{ "item": "Bundle", "stacksize": 1, "chance": 0.33333333333333337, "structure": "Abandoned Camp", "container": "Barrel" }
| ||
| Cartographer's chest | 1 | 33.3%{ "item": "Bundle", "stacksize": 1, "chance": 0.33333333333333337, "structure": "Village", "container": "Cartographer's chest" }
| ||
| Savanna house chest | 1 | 33.3%{ "item": "Bundle", "stacksize": 1, "chance": 0.33333333333333337, "structure": "Village", "container": "Savanna house chest" }
| ||
| Snowy house chest | 1 | 33.3%{ "item": "Bundle", "stacksize": 1, "chance": 0.33333333333333337, "structure": "Village", "container": "Snowy house chest" }
| ||
| Desert house chest | 1 | 33.3%{ "item": "Bundle", "stacksize": 1, "chance": 0.33333333333333337, "structure": "Village", "container": "Desert house chest" }
| ||
| Plains house chest | 1 | 33.3%{ "item": "Bundle", "stacksize": 1, "chance": 0.33333333333333337, "structure": "Village", "container": "Plains house chest" }
| ||
| Taiga house chest | 1 | 33.3%{ "item": "Bundle", "stacksize": 1, "chance": 0.33333333333333337, "structure": "Village", "container": "Taiga house chest" }
| ||
| Weaponsmith's chest | 1 | 33.3%{ "item": "Bundle", "stacksize": 1, "chance": 0.33333333333333337, "structure": "Village", "container": "Weaponsmith's chest" }
| ||
| Tannery chest | 1 | 33.3%{ "item": "Bundle", "stacksize": 1, "chance": 0.33333333333333337, "structure": "Village", "container": "Tannery chest" }
| ||
Usage
Bundles are used to store different item types in the same inventory slot. This does not however increase the total capacity of the slot, as bundles can store only what would otherwise add up to a single slot. Items that can normally stack up to 64 take up 1⁄64 of a bundle, items that can normally stack up to 16 (e.g. eggs, ender pearls) take up 1⁄16 of a bundle, and items that do not stack take up the entirety of a bundle (e.g. swords with an exception of bundles themselves). In Java Edition, the space that an item takes up in a bundle is equal to the reciprocal of its max_stack_size component, even if it is different from the standard 1, 16, and 64.
Bundles are not stackable, but they are able to be placed (nested) inside another.[1] Each bundle placed inside another bundle consumes 1⁄16 of the space of the outer bundle plus the space occupied by the inner bundle's contents. In Java Edition, the space taken up by a bundle is not affected by its max_stack_size component.
Shulker boxes cannot be placed inside of bundles. However, bundles can be placed inside of shulker boxes.
Bee nest and beehive with bees occupy the space of a full item stack, even though they are stackable. In Java Edition, the space taken up by a item with non-empty bees component is not affected by its max_stack_size component.
Inserting items
While in an inventory screen, items are inserted into bundles by pressing the "Take" inventory control (left click, or
(Xbox) /
(Switch) /
(PlayStation) on a controller, or tapping on a touch screen). This can be done in the following ways:
- Picking up the bundle and left-clicking/pressing "Take"/tapping on the item(s) to be placed inside. This allows storing other bundles into a bundle.
- Picking up item(s) and left-clicking/pressing "Take"/tapping on the bundle.
Retrieving items
When using a mouse or a controller, items are retrieved from bundles by pressing the "Take half" inventory control (right click, or
(Xbox) /
(Switch) /
(PlayStation) on a controller):
- When hovering over a bundle with an empty cursor, right-clicking/pressing "Take half" causes the cursor to hold the item from the most recently added slot of the bundle.
- When hovering over a bundle with an empty cursor, moving the
Scroll Wheel or right stick allows for scrolling through the bundle's slots, starting from the most recently added item. The selected item slot is displayed with a bright underlay behind that item. During this process, the bundle's inventory icon appears open, and the selected slot's item icon appears within the bundle's icon. By right-clicking/pressing "Take half", the currently selected item moves to the cursor and the bundle closes. The bundle also closes when the cursor is moved off the bundle while it's still open, without retrieving any item. - When a bundle is held in the cursor and the cursor is hovering over an empty slot, right-clicking/pressing "Take half" causes the most recently added item to be placed in that slot. If the item cannot be placed into that slot (e.g. a dirt block in the helmet slot), the item is not retrieved.
When using touch controls, items can be retrieved by tapping on a bundle in the inventory, then tapping on an item to take out, and lastly tapping on an empty slot. If the item cannot be placed into that slot (e.g. a dirt block in the helmet slot), the item is not retrieved.
Using a bundle while it is selected in the hotbar causes the contents of the most recently added slot to be thrown out in the direction the player is facing.
When a bundle item entity is destroyed (e.g. thrown onto fire or into a cactus), the contents of the bundle are dropped as items, similar to when a shulker box is destroyed.
GUI

Hovering over a bundle reveals its blue fullness bar. When the bundle is empty, the fullness bar says "Empty" and shows the description, "Can hold a mixed stack of items". If it's completely full, the fullness bar turns red and says "Full". When there is at least one item in a bundle, space opens up above the bar, which displays the items in the bundle's slots, sorted by how recently they were added, from right to left. The space where the slots are shown is wide enough for four slots, so additional space opens up for new rows. When there are more than three rows, only the top three are displayed, and the bottom-right slot is replaced by text that says, +<number of slots hidden>, where the slot replaced by the text counts toward that number.
Bundles show an additional fullness bar on their icons, similarly to how items that are damaged show their durability. Bundle fullness bars are blue, or red when full, and appear when the bundle contains at least one item.
Sounds
| Sounds | ||||||||
|---|---|---|---|---|---|---|---|---|
| Sound | Closed captions | Source | Description | Identifier | Translation key | Volume | Pitch | Attenuation distance |
| Bundle empties | Players | When a bundle's items are thrown onto the ground | item | subtitles | 0.8 | varies[sound 1] | 16 | |
| Item packed[until: JE 26.4] | Players | When items are placed into a bundle | item | subtitles | 0.8 | varies[sound 2] | 16 | |
| Bundle full[until: JE 26.4] | Players | When items cannot be placed into a bundle | item | subtitles | 1.0 | 1.0 | 16 | |
| Item unpacked[until: JE 26.4] | Players | When items are removed from a bundle | item | subtitles | 0.8 | varies[sound 3] | 16 | |
| Sounds | |||||||
|---|---|---|---|---|---|---|---|
| Sound | Closed captions | Source | Description | Identifier | Translation key | Volume | Pitch |
| ? | Players | When a bundle's items are thrown onto the ground | bundle | ? | 1.0 | varies | |
| ? | Players | When items are placed into a bundle | bundle | ? | 1.0 | varies | |
| ? | Players | When items cannot be placed into a bundle | bundle | ? | 1.0 | 1.0 | |
| ? | Players | When items are removed from a bundle | bundle | ? | 1.0 | varies[sound 3] | |
Data values
ID
| Name | Identifier | Form | Item tags | Translation key |
|---|---|---|---|---|
bundle | Item | bundles |
item | |
white_bundle | Item | bundles |
item | |
orange_bundle | Item | bundles |
item | |
magenta_bundle | Item | bundles |
item | |
light_blue_bundle | Item | bundles |
item | |
yellow_bundle | Item | bundles |
item | |
lime_bundle | Item | bundles |
item | |
pink_bundle | Item | bundles |
item | |
gray_bundle | Item | bundles |
item | |
light_gray_bundle | Item | bundles |
item | |
cyan_bundle | Item | bundles |
item | |
purple_bundle | Item | bundles |
item | |
blue_bundle | Item | bundles |
item | |
brown_bundle | Item | bundles |
item | |
green_bundle | Item | bundles |
item | |
red_bundle | Item | bundles |
item | |
black_bundle | Item | bundles |
item |
| Name | Identifier | Numeric ID | Form | Translation key |
|---|---|---|---|---|
bundle | 260 | Item | item | |
white_bundle | 272 | Item | item | |
orange_bundle | 268 | Item | item | |
magenta_bundle | 267 | Item | item | |
light_blue_bundle | 264 | Item | item | |
yellow_bundle | 273 | Item | item | |
lime_bundle | 266 | Item | item | |
pink_bundle | 269 | Item | item | |
gray_bundle | 262 | Item | item | |
light_gray_bundle | 265 | Item | item | |
cyan_bundle | 261 | Item | item | |
purple_bundle | 270 | Item | item | |
blue_bundle | 258 | Item | item | |
brown_bundle | 259 | Item | item | |
green_bundle | 263 | Item | item | |
red_bundle | 271 | Item | item | |
black_bundle | 257 | Item | item |
Item data
- [NBT Compound / JSON Object] components: the item's components tag.
- [NBT List / JSON Array] minecraft:bundle_contents: The items stored inside this bundle. Adding this component to any item changes that item to occupy 1/16 of the space of a bundle plus any items specified in the component, regardless of how of that item normally fit in a bundle. Shulker boxes with this component are still not able to be placed inside a bundle. If this component is removed from a bundle, it cannot be used by the player and the usual instruction and fullness bar does not appear in the tooltip.
- [NBT Compound / JSON Object]: A single item stack.
- A single item stack see Template:Nbt inherit/itemnoslot/template
- [NBT Compound / JSON Object]: A single item stack.
- [NBT List / JSON Array] minecraft:bundle_contents: The items stored inside this bundle. Adding this component to any item changes that item to occupy 1/16 of the space of a bundle plus any items specified in the component, regardless of how of that item normally fit in a bundle. Shulker boxes with this component are still not able to be placed inside a bundle. If this component is removed from a bundle, it cannot be used by the player and the usual instruction and fullness bar does not appear in the tooltip.
Videos
History
Development
| October 3, 2020 | |||||||
|---|---|---|---|---|---|---|---|
| October 16, 2021 | Ulraf states that bundles are not included in Caves & Cliffs due to UI difficulties, primarily in Bedrock Edition. | ||||||
| November 17, 2021 | Bundles are announced to be added after The Wild Update. | ||||||
| September 28, 2024 | Bundles are announced to be added in the Bundles of Bravery drop. | ||||||
Java Edition
| Java Edition | |||||||
|---|---|---|---|---|---|---|---|
| 1.17 | 20w45a | ||||||
| The crafting recipe was originally 2 strings and 6 rabbit hides. | |||||||
| 20w46a | |||||||
| Hovering over bundles now shows its contained items in special slots, similar to slots in the inventory. If the bundle is not full, it also has an empty slot with a plus on it. | |||||||
| 20w48a | Bundles now show fullness as a number when advanced tooltips are enabled. | ||||||
| Using a bundle in the inventory now empties the last item inserted in the bundle instead of emptying all the contents out to the inventory. | |||||||
| Using a bundle now throws out its entire content into the world. | |||||||
| 20w49a | Bundle fullness is now always shown. | ||||||
| Full bundles now show the blue bar instead of hiding it, to distinguish from empty bundles. | |||||||
| 20w51a | Bundles now drop its contents when destroyed as an item entity. | ||||||
Bundle fullness has been changed from Fullness: <fullness> / 64 to <fullness>/64 | |||||||
| The slots in the tooltip when hovering over bundles have changed to have a border, and rows of slot have a thicker edge between them. | |||||||
| When the bundle is not full, it instead shows empty slots instead of one slot with a plus. When it is full, those empty slots become greyed out with an X. | |||||||
| 21w05a | The player now receives a tutorial when first having a bundle in the inventory. | ||||||
| 21w19a | Bundles are now accessible only through commands. | ||||||
| 1.18 | Experimental Snapshot 1 | Bundles are now available in the creative inventory and can be crafted once again. | |||||
| 21w37a | Bundles are once again accessible only through commands. | ||||||
| 1.19.3 Experiment | 22w42a | Bundles have been made available once again, and have been moved behind their own data pack. | |||||
| 1.21.2 Experiment | 24w33a | Bundles are now crafted with one string and one leather instead of two string and six rabbit hide. | |||||
| The closed texture is now used as the default instead of the open texture. | |||||||
| The tooltip now acts as a sub-menu, wherein the player can now use the | |||||||
| 24w34a | The bundle's tooltip now fits 3 rows and can always show at least 8 item types. | ||||||
| 24w35a | The number keys can no longer be used to select items in a bundle. | ||||||
| 24w36a | When a bundle is used in the hotbar, one group of items is emptied at a time instead of everything being emptied at once. | ||||||
| 24w38a | |||||||
| 1.21.2 | 24w39a | Bundles are now available without toggling its respective data pack. | |||||
| 24w40a | Bundles can no longer be dyed the same color they already are. | ||||||
| 1.21.4 | 24w46a | Items in the bundle tooltip now have a gray background. | |||||
| 1.21.5 | 25w07a | Bundles can now be found in some village chests. | |||||
| 26.3 | snap1 | Bundles can now generate as part of abandoned camps in barrels and chests. | |||||
Bedrock Edition
| Bedrock Edition | |||||||
|---|---|---|---|---|---|---|---|
| June 29, 2024 | |||||||
| 1.21.30 Experiment | Preview 1.21.30.23 | ||||||
| Preview 1.21.30.24 | The bundle's tooltip now fits 3 rows and can always show at least 8 item types. | ||||||
| 1.21.40 Experiment | Preview 1.21.40.20 | When a bundle is used in the hotbar, one group of items is emptied at a time instead of everything being emptied at once. | |||||
| Preview 1.21.40.22 | |||||||
| 1.21.40 | Preview 1.21.40.23 | ||||||
| Bundles are now available without toggling its respective experimental toggle. | |||||||
| 1.21.50 | Preview 1.21.50.28 | Items in the bundle tooltip now have a gray background. | |||||
| Preview 1.21.50.29 | Using the | ||||||
| 1.21.60 | Preview 1.21.60.24 | ||||||
| 1.21.70 | Preview 1.21.70.23 | Bundles can now be found in some village chests. | |||||
| 26.40 Experiment | Preview 26.40.27 | Bundles can now generate as part of abandoned camps in barrels and chests. | |||||
| 26.50 | Preview 26.50.22 | All features from the "Drop 3 of 2026" experiment have been fully implemented. | |||||
Issues
Issues relating to "Bundle" are maintained on the bug tracker. Issues should be reported and viewed there.
Trivia
- Bundles are inspired by the ancient Roman coin purse, which have been used for thousands of years.[2]
- The reason for why bundles can be dyed in 16 colors rather than a combination of multiple colors (like leather armor) is that Mojang considered it more important for players to be able to quickly identify the color of the bundle rather than being able to fully customize the color.[3]
- Bundles are the first non-block item that uses the 16 color dyes versus the 2^24 leather dye system[4] (besides dyes themselves).
- Bundle is the last feature announced at Minecraft Live 2020 to be released. Minecraft Live 2020 took place on October 3, 2020, with the bundles announced for the Caves & Cliffs update while Bundles of Bravery was not released until 4 years and 19 days later on October 22, 2024.
Gallery
Mojang screenshots
-
The old bundle UI shown at Minecraft Live 2020. -
The old bundle UI. -
A bundle of bundles on the beach. -
Some items being put into a bundle. -
A bundle being used to store food. -
Bundle in hand. -
Some bundles floating next to a jungle. -
A bundle hovering near a rabbit. -

-
Makena holding a bundle. -
Ari with a collection of dyed bundles. -
Some foxes around dyed bundles. -
A sheep and rows of dyed bundles. -
Sunny in front of a collection of dyed bundles. -
Several dyed bundles. -
Several bundles in Kai's inventory.
In other media
-
Alex with bundles on head. -
Ari using a bundle in the Bundles of Bravery - Official Trailer. -
Bundles as seen in A Minecraft Movie.
References
- ↑ MC-203567 – Bundles can be placed inside of bundles – resolved as "Works As Intended".
- ↑ "BUNDLES ARE FINALLY IN MINECRAFT!" – Minecraft on YouTube, October 23, 2024
- ↑ "Implementing Bundles has been quite the journey, and I'm extremely proud of the team for where they've gotten the feature at this point" – @Xilefian on X (formerly Twitter), September 29, 2024
"For leather armours the dye system is part of the self expression of wearing the armour (which is a primary feature of those items)
Bundles are closer to Shulker Boxes: It is more important a player can quickly see a colour and judge the contents of the container
(1/2)" – @Xilefian on X (formerly Twitter), September 29, 2024
"And to make sure players can quickly see and judge a colour it's best we have artists pick the ideal set of colours
We can tweak each of those 16 bundle textures, versus having artists trying to tweak the visibility of 16,777,216 colours that the leather dye system provides
(2/2)" – @Xilefian on X (formerly Twitter), September 29, 2024
"For context I asked the team the same question when I was reviewing the Bedrock code because - by chance - Bundles are the first non-block item that uses the 16 colour dyes versus the 2^24 leather dye system (which non-block items have used up until Bundles)" – @Xilefian on X (formerly Twitter), September 29, 2024 - ↑ "For context I asked the team the same question when I was reviewing the Bedrock code because - by chance - Bundles are the first non-block item that uses the 16 colour dyes versus the 2^24 leather dye system (which non-block items have used up until Bundles)" – @Xilefian on X (formerly Twitter), September 29, 2024









































