| Item description[BE only] | Storage |
|---|---|
| Renewable | Yes |
| Stackable | No |
| Tool | |
| Blast resistance | 2 |
| Hardness | 2 |
| Luminous | No |
| Transparent | JE: No BE: Yes |
| Waterloggable | JE: No BE: Yes |
| Flammable | No |
| Catches fire from lava |
No |
| Map color | 24 COLOR 8 SNOW
|
| Note block instrument | Default (Harp) |
A shulker box is a dyeable block that stores items, and, unlike all other storage blocks, keeps its contents in item form when broken.
Obtaining
Breaking
All shulker boxes can be mined with any tool or by hand, but using a pickaxe is the most effective. All shulker boxes drop themselves when mined. Unlike other containers, the contents of any shulker box are stored within the dropped item, and not dropped separately. When instantly mined in Creative mode, all shulker boxes drop as an item if there are items stored within, unless /gamerule doTileDrops is set to "false".
| Block | ||
|---|---|---|
| Hardness | 2 | |
| Tool | ||
| Breaking time (sec)[A] | ||
| Default | 3 (JE) 3 (BE) | |
| 1.5 (JE) 1.5 (BE) | ||
| 0.75 (JE) 0.75 (BE) | ||
| 0.6 (JE) 0.6 (BE) | ||
| 0.5 (JE) 0.5 (BE) | ||
| 0.4 (JE) 0.4 (BE) | ||
| 0.35 (JE) 0.35 (BE) | ||
| 0.25 (JE) 0.25 (BE) | ||
- incorrect tool, drops nothing
- correct tool, drops nothing or something other than the block itself
- correct tool, drops the block itself
- italicized can be instant mined
- ↑ These durations ignore any other influential factors (e.g., Mining Fatigue) and are measured in seconds. For more information, see Breaking § Mining efficiency.
When a shulker box is pushed by a piston, it breaks and drops as an item. It cannot be pulled.
Crafting
| Name | Ingredients | Crafting recipe | Notes |
|---|---|---|---|
| Shulker Box | Shulker Shell + Chest |
||
| Dyed Shulker Box | Any Shulker Box + Matching Dye |
When you dye the shulker box, it retains its contents. If it is renamed on an anvil, it also retains its contents. |
Usage
Storage

All shulker boxes have 27 inventory slots, the same as a barrel, a single chest, or an ender chest.
All shulker boxes keep their items when broken, which can be retrieved when placed again, thus making them portable chests. This is different from other containers, which drop their contained items as item entities when broken. A shulker box drops itself as an item if pushed by pistons or destroyed by an explosion. If, however, the shulker box is in item form and is destroyed, the contents of the shulker box are dropped as items. Unlike most blocks with an inventory, shulker boxes always drop themselves when destroyed by explosions. When a shulker box with items inside is being held[Bedrock Edition only] or is in a container's inventory, the items are listed on the tooltip as properties.

Any shulker box's items can be fed or removed by a hopper.
All shulker boxes can be stored in all containers except for other shulker boxes and bundles.
When placed by a player, a shulker box faces toward the player placing it. For example, if a shulker box is placed on a floor, a wall or a ceiling, it faces and opens upward, sideways or upside-down, respectively. Dispensers can also be used to place shulker boxes. If there is no block below the space where the shulker box is placed, the shulker box faces identically to the dispenser. Otherwise, the shulker box always faces upward, even if the block has no hitbox such as torches, signs and open fence gates.
Like a chest, all shulker boxes require a transparent area in the direction of its top surface to be opened. That area is exactly half of a full block, and clear of any obstructions, which may be any other hitbox, including blocks, boats and shulkers[Java Edition only], or a redstone conductive block[Bedrock Edition only]. This way, any shulker box can be opened with an upside-down slab or an upper trapdoor on top of it. It is also unique in that when opened, its hitbox expands to 1.5 blocks high/wide, physically pushing entities where it is facing.
By default, the GUI of any shulker box is labeled "Shulker Box", which can be changed by naming it in an anvil or by changing the CustomName tag using the /data command.[Java Edition only]
When any shulker box item is destroyed, the contents of the shulker box are dropped as items.
Although the blocks can't be placed in the void, opening a shulker box can make its hitbox expand to the void.
Piglins
Piglins become hostile toward players who open or mine any shulker box.[1]
Undyeing
Dyed shulker boxes can be undyed using a cauldron. To do this, use a dyed shulker box on a cauldron that has water in it. This causes the cauldron's water level to decrease by 1, and the dyed shulker box loses its dye color.
Redstone component
The fullness of any shulker boxes, even if they cannot be opened, can be read by redstone comparators, unlike chests.
Observers can detect the opening and closing of any shulker boxes.
Shulker boxes are conductive when closed, but not if open. However, opening or closing a shulker box does not update its neighboring blocks, which can be used to create BUD state redstone wires[JE only].
Sounds
Generic
stone sound type | ||||||||
|---|---|---|---|---|---|---|---|---|
| Sound | Closed captions | Source | Description | Identifier | Translation key | Volume | Pitch | Attenuation distance |
| Block broken | Blocks | Once the block has broken | block | subtitles | 1.0 | 0.8 | 16 | |
| Block placed[until: JE 26.4] | Blocks | When the block is placed | block | subtitles | 1.0 | 0.8 | 16 | |
| Block breaking | Blocks | While the block is in the process of being broken | block | subtitles | 0.25 | 0.5 | 16 | |
| Something falls on a block | Entity-Dependent | Falling on the block with fall damage | block | subtitles | 0.5 | 0.75 | 16 | |
| Footsteps | Entity-Dependent | Walking on the block | block | subtitles | 0.15 | 1.0 | 16 | |
stone sound type | |||||||
|---|---|---|---|---|---|---|---|
| Sound | Closed captions | Source | Description | Identifier | Translation key | Volume | Pitch |
| Block broken | Blocks | Once the block has broken | dig | subtitles | 1.0 | 0.8–1.0 | |
| Block placed | Blocks | When the block is placed | place | subtitles | 1.0 | 0.8–1.0 | |
| Block breaking | Blocks | While the block is in the process of being broken | hit | subtitles | 0.37 | 0.5 | |
| Footsteps | Players | Falling on the block with fall damage | fall | subtitles | 0.4 | 1.0 | |
| Footsteps | Players | Walking on the block | step | subtitles | 0.3 | 1.0 | |
| Footsteps | Blocks | Jumping from the block | jump | subtitles | 0.12 | 1.0 | |
| Footsteps | Blocks | Falling on the block without fall damage | land | subtitles | 0.22 | 1.0 | |
Unique
| Sounds | ||||||||
|---|---|---|---|---|---|---|---|---|
| Sound | Closed captions | Source | Description | Identifier | Translation key | Volume | Pitch | Attenuation distance |
| Shulker box closes | Blocks | When a shulker box closes | block | subtitles | 0.5 | 0.9–1.0 | 16 | |
| Shulker box opens | Blocks | When a shulker box opens | block | subtitles | 0.5 | 0.9–1.0 | 16 | |
| Chest locked[until: JE 26.4][sound 2] | Blocks | When a player attempts to open a shulker box locked using the [NBT Compound / JSON Object] lock tag | block[sound 2] | subtitles[sound 2] | 1.0 | 1.0 | 16 | |
| Sounds | |||||||
|---|---|---|---|---|---|---|---|
| Sound | Closed captions | Source | Description | Identifier | Translation key | Volume | Pitch |
| ? | Blocks | When a shulker box closes | random | ? | 0.5 | 0.9–1.0 | |
| ? | Blocks | When a shulker box opens | random | ? | 0.5 | 0.9–1.0 | |
Data values
ID
| Name | Identifier | Form | Block tags | Translation key |
|---|---|---|---|---|
shulker_box | Block & Item | guarded_by_piglinsshulker_boxes |
block | |
white_shulker_box | Block & Item | guarded_by_piglinsshulker_boxes |
block | |
orange_shulker_box | Block & Item | guarded_by_piglinsshulker_boxes |
block | |
magenta_shulker_box | Block & Item | guarded_by_piglinsshulker_boxes |
block | |
light_blue_shulker_box | Block & Item | guarded_by_piglinsshulker_boxes |
block | |
yellow_shulker_box | Block & Item | guarded_by_piglinsshulker_boxes |
block | |
lime_shulker_box | Block & Item | guarded_by_piglinsshulker_boxes |
block | |
pink_shulker_box | Block & Item | guarded_by_piglinsshulker_boxes |
block | |
gray_shulker_box | Block & Item | guarded_by_piglinsshulker_boxes |
block | |
light_gray_shulker_box | Block & Item | guarded_by_piglinsshulker_boxes |
block | |
cyan_shulker_box | Block & Item | guarded_by_piglinsshulker_boxes |
block | |
purple_shulker_box | Block & Item | guarded_by_piglinsshulker_boxes |
block | |
blue_shulker_box | Block & Item | guarded_by_piglinsshulker_boxes |
block | |
brown_shulker_box | Block & Item | guarded_by_piglinsshulker_boxes |
block | |
green_shulker_box | Block & Item | guarded_by_piglinsshulker_boxes |
block | |
red_shulker_box | Block & Item | guarded_by_piglinsshulker_boxes |
block | |
black_shulker_box | Block & Item | guarded_by_piglinsshulker_boxes |
block |
| Name | Identifier |
|---|---|
shulker_box |
| Name | Identifier | Alias ID | Numeric ID | Form | Item ID[i 1] | Block tags | Translation key |
|---|---|---|---|---|---|---|---|
undyed_shulker_box | None | 205 | Block & Giveable Item[i 2] | Identical[i 3] | minecraft:is_pickaxe_item_destructible |
tile | |
white_shulker_box | shulker_box / 0 | 218 | Block & Giveable Item[i 2] | Identical[i 3] | minecraft:is_pickaxe_item_destructible |
tile | |
orange_shulker_box | shulker_box / 1 | 868 | Block & Giveable Item[i 2] | Identical[i 3] (Numeric: -613) | minecraft:is_pickaxe_item_destructible |
tile | |
magenta_shulker_box | shulker_box / 2 | 869 | Block & Giveable Item[i 2] | Identical[i 3] (Numeric: -614) | minecraft:is_pickaxe_item_destructible |
tile | |
light_blue_shulker_box | shulker_box / 3 | 870 | Block & Giveable Item[i 2] | Identical[i 3] (Numeric: -615) | minecraft:is_pickaxe_item_destructible |
tile | |
yellow_shulker_box | shulker_box / 4 | 871 | Block & Giveable Item[i 2] | Identical[i 3] (Numeric: -616) | minecraft:is_pickaxe_item_destructible |
tile | |
lime_shulker_box | shulker_box / 5 | 872 | Block & Giveable Item[i 2] | Identical[i 3] (Numeric: -617) | minecraft:is_pickaxe_item_destructible |
tile | |
pink_shulker_box | shulker_box / 6 | 873 | Block & Giveable Item[i 2] | Identical[i 3] (Numeric: -618) | minecraft:is_pickaxe_item_destructible |
tile | |
gray_shulker_box | shulker_box / 7 | 874 | Block & Giveable Item[i 2] | Identical[i 3] (Numeric: -619) | minecraft:is_pickaxe_item_destructible |
tile | |
light_gray_shulker_box | shulker_box / 8 | 875 | Block & Giveable Item[i 2] | Identical[i 3] (Numeric: -620) | minecraft:is_pickaxe_item_destructible |
tile | |
cyan_shulker_box | shulker_box / 9 | 876 | Block & Giveable Item[i 2] | Identical[i 3] (Numeric: -621) | minecraft:is_pickaxe_item_destructible |
tile | |
purple_shulker_box | shulker_box / 10 | 877 | Block & Giveable Item[i 2] | Identical[i 3] (Numeric: -622) | minecraft:is_pickaxe_item_destructible |
tile | |
blue_shulker_box | shulker_box / 11 | 878 | Block & Giveable Item[i 2] | Identical[i 3] (Numeric: -623) | minecraft:is_pickaxe_item_destructible |
tile | |
brown_shulker_box | shulker_box / 12 | 879 | Block & Giveable Item[i 2] | Identical[i 3] (Numeric: -624) | minecraft:is_pickaxe_item_destructible |
tile | |
green_shulker_box | shulker_box / 13 | 880 | Block & Giveable Item[i 2] | Identical[i 3] (Numeric: -625) | |
tile | |
red_shulker_box | shulker_box / 14 | 881 | Block & Giveable Item[i 2] | Identical[i 3] (Numeric: -626) | minecraft:is_pickaxe_item_destructible |
tile | |
black_shulker_box | shulker_box / 15 | 882 | Block & Giveable Item[i 2] | Identical[i 3] (Numeric: -627) | minecraft:is_pickaxe_item_destructible |
tile |
| Name | Savegame ID |
|---|---|
ShulkerBox |
Block states
| Name | Default value | Allowed values | Description |
|---|---|---|---|
| facing | up | downeastnorthsouthupwest | The direction the shulker box is pointing. The opposite from the direction the player faces while placing the shulker box. |
Block data
A shulker box has a block entity associated with it that identifies its contents.
- [NBT Compound / JSON Object] Block entity data
- Tags common to all block entities see Template:Nbt inherit/blockentity/template
- Tags common to all objects that can be renamed see Template:Nbt inherit/nameable/template
- Tags common to all containers that can be locked see Template:Nbt inherit/lockable/template
- Tags common to all objects that use loot tables to produce items see Template:Nbt inherit/lootable/template
- [NBT List / JSON Array] Items: List of items in this container. Does not exist if the shulker box is empty (unlike all other container blocks with the
Itemstag, which store an empty list). Represents theminecraft:containercomponent. The component is still present on the block entity, even if the tag does not exist.- [NBT Compound / JSON Object]: An item, including the slot tag. Shulker box slots are numbered 0–26, 0 starts in the top left corner.
- An item stack in a container slot see Template:Nbt inherit/item/template
- [NBT Compound / JSON Object]: An item, including the slot tag. Shulker box slots are numbered 0–26, 0 starts in the top left corner.
Item data
- [NBT Compound / JSON Object] components: the item's components tag.
- [NBT Compound / JSON Object] minecraft:block_entity_data: Block entity NBT applied when this block is placed. Depending on the block type that this item places, and the block entity ID specified in this component, this component may add a red message to the item's tooltip (for operator players only) warning the player that placing it may result in command execution.
- See Block entity format. Must include
idtag. Excludesx,y,z,componentsandkeepPackedtags.
- See Block entity format. Must include
- [NBT List / JSON Array] minecraft:container: The items contained in this container's slots. If present on an item, the first 5 item slots in the container are listed in the tooltip, and the number of any extra slots are listed as "and
<N>more..." underneath (only seen on shulker boxes in normal gameplay or ctrl-middle-clicked containers in creative mode). This component supports up to 256 item slots but, when present on some block entities, the number of slots may be artificially limited based on the number of slots the block needs (e.g. 1 for decorated pots, and 27 for chests).- [NBT Compound / JSON Object]: A single item.
- [NBT Compound / JSON Object] item: The item stack in this slot.
- A single item stack see Template:Nbt inherit/itemnoslot/template
- [Int] slot: A slot in this container. Can be from 0 to 255 (inclusive).
- [NBT Compound / JSON Object] item: The item stack in this slot.
- [NBT Compound / JSON Object]: A single item.
- [NBT Compound / JSON Object] minecraft:container_loot: The unresolved loot table and seed of this container item.
- [String] loot_table: The ID of a loot table.
- [Long] seed: The pseudorandom seed to resolve the loot table with. If not specified or 0, a seed is randomly chosen by the game.
- [NBT Compound / JSON Object] minecraft:block_entity_data: Block entity NBT applied when this block is placed. Depending on the block type that this item places, and the block entity ID specified in this component, this component may add a red message to the item's tooltip (for operator players only) warning the player that placing it may result in command execution.
- [String][NBT List / JSON Array][NBT Compound / JSON Object] minecraft:custom_name: The player-assigned name of this item, block, or entity, typically assigned with an anvil or a name tag. See Text component format.
- If present on an item, this component has highest priority to display as the item's name, and appears italic unless overridden by the text component format.
- If present on an entity, it will replace the entity's name tag, will show the name tag to players when they hover over the entity (unless invisible), and will appear as that entity's name in commands and chat messages.
- If present on a block with a GUI (such as a container), this replaces the name at the top of the GUI.
- If present on a command block, this replaces the execution context name when the command is ran.
- [NBT Compound / JSON Object] minecraft:lock: An item predicate representing the "key" to open this container. If present on a block, players must have an item that passes this predicate in their main hand in order to open the container. If they do not, interacting with the container will play a sound and display a message in the actionbar.
- item predicate see Template:Nbt inherit/conditions/item/template
Achievements
| Icon | Achievement | In-game description | Actual requirements (if different) | Gamerscore earned | Trophy type (PS) | |
|---|---|---|---|---|---|---|
| PS4 | Other | |||||
| Organizational Wizard | Name a Shulker Box with an Anvil | Rename a dyed shulker box; an undyed shulker box will not work. | 30 | Bronze | ||
History
Java Edition
| Java Edition | |||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 1.11 | 16w39a | ||||||||||||||||||||||||||||||||||
| 16w39c | "Silver Shulker Boxes" have been now renamed to "Light Grey Shulker Boxes", in keeping with naming consistencies across dyed blocks. | ||||||||||||||||||||||||||||||||||
| 16w40a | Renamed "Light Grey Shulker Box" to "Light Gray Shulker Box".[2] | ||||||||||||||||||||||||||||||||||
| 1.12 | 17w16a | ||||||||||||||||||||||||||||||||||
| 17w17a | |||||||||||||||||||||||||||||||||||
| 1.13 | 17w47a | The ID for the light gray shulker box has been changed from silver_shulker_box to light_gray_shulker_box.
| |||||||||||||||||||||||||||||||||
As part of The Flattening, the numeric IDs of all types of shulker boxes have been removed.
| |||||||||||||||||||||||||||||||||||
| 18w10b | |||||||||||||||||||||||||||||||||||
| Purple shulker boxes from previous versions are now converted to default shulker boxes instead of purple ones. | |||||||||||||||||||||||||||||||||||
| 18w10d | Dyed shulker boxes can now be undyed in a cauldron. | ||||||||||||||||||||||||||||||||||
| Undyed shulker boxes can now be obtained by undyeing dyed shulker boxes in a cauldron. | |||||||||||||||||||||||||||||||||||
| 1.17 | 20w45a | Shulker post-generation mechanic is now added, making all shulker boxes renewable. | |||||||||||||||||||||||||||||||||
| 20w51a | All shulker boxes now drop their contents when destroyed as an item entity. | ||||||||||||||||||||||||||||||||||
| 1.19.3 | 22w45a | Blocks attached to the sides and lid of any shulker box now pop off when the shulker box opens.[3] | |||||||||||||||||||||||||||||||||
Bedrock Edition
| Pocket Edition | |||||||
|---|---|---|---|---|---|---|---|
| 1.1.0 | alpha 1.1.0.0 | ||||||
| alpha 1.1.0.9 | |||||||
| ? | ? | Shulker boxes no longer use the wood sound. | |||||
| Bedrock Edition | |||||||
| 1.2.0 | beta 1.2.0.2 | ||||||
| 1.2.3 | "Silver Shulker Boxes" have been now renamed to "Light Gray Shulker Boxes", in keeping with naming consistencies across dyed blocks. | ||||||
| 1.8.0 | beta 1.8.0.13 | A recipe for undyed shulker boxes has been added. | |||||
| 1.16.0 | beta 1.16.0.51 | Dyed shulker boxes can now be undyed in a cauldron. | |||||
| Undyed shulker boxes can now be obtained by undyeing dyed shulker boxes in a cauldron. | |||||||
| 1.17.30 | beta 1.17.30.22 | All shulker boxes now drop their contents when destroyed as an item entity. | |||||
| 1.18.30 | beta 1.18.30.22 | Shulker post-generation mechanic is now added, making all shulker boxes renewable. | |||||
| 1.20.10 | Preview 1.20.10.20 | The different block states for the dyed shulker box ID, the shulker_box ID, have been split into their own IDs. | |||||
| 1.20.30 | Preview 1.20.20.21 | Decreased the hardness and blast resistance of shulker boxes and dyed shulker boxes from 2.5 to 2. | |||||
| Shulker boxes no longer receive a mining speed penalty when being mined without a pickaxe. | |||||||
Legacy Console Edition
| Legacy Console Edition | |||||||
|---|---|---|---|---|---|---|---|
| Xbox 360 | Xbox One | PS3 | PS4 | PS Vita | Wii U | Switch | |
| TU53 | CU43 | 1.49 | 1.50 | 1.49 | Patch 23 | 1.0.3 | |
| TU63 | CU53 | 1.67 | 1.67 | 1.67 | Patch 32 | 1.0.13 | Shulker boxes can no longer be opened when an entity is inside the area that the shulker box's collision box would extend to when opened. |
| 1.88 | |||||||
New Nintendo 3DS Edition
| New Nintendo 3DS Edition | |||||||
|---|---|---|---|---|---|---|---|
| 1.9.19 | |||||||
| There is no default shulker box separate from the purple shulker box; the purple shulker box uses the texture of the default shulker box. | |||||||
Issues
Issues relating to "Shulker Box" are maintained on the bug tracker. Issues should be reported and viewed there.
Trivia
- With 37 shulker boxes in a player's inventory, hotbar, and off-hand slot, 999 stacks of up to 64 items (up to 63,936 total items; 63,973 if counting shulker boxes themselves) can be held. With 37 shulker boxes and an ender chest with 27 shulker boxes in one of the shulker box slots, 1,727 stacks (up to 110,528 items; 1,728 stacks with up to 110,592 items if counting stacked ender chests) can be held.[Java Edition only]
- Before they were added to Minecraft, storage objects that keep their inventory when picked up were already present in Minicraft.
Gallery
Renders
Opening and closing animations
Open
In other media
-
Monty with two shulker boxes
References
External links
- Block of the Week: Shulker Box – Minecraft.net on November 19, 2020






