Mineuniverse
Log in Register
Shelf

Shelf

A shelf is a block that can store and display up to three stacks of items. Using an item slot exchanges its contents with the player's hotbar. Powering a…

13 min read Updated 6 views
Blocks Stackable resources Renewable resources Manufactured blocks Utility blocks Redstone Mechanisms Readable by comparators
Advertisement Remove ads with Premium →
Contents (24)
  1. Obtaining
  2. Breaking
  3. Crafting
  4. Usage
  5. Holding items
  6. Redstone
  7. Fuel
  8. Sounds
  9. Generic
  10. Unique
  11. Data values
  12. ID
  13. Block states
  14. Block data
  15. History
  16. Announcement
  17. Java Edition
  18. Bedrock Edition
  19. Issues
  20. Gallery
  21. Textures
  22. Renders
  23. Mojang screenshots
  24. See also
For other uses, see Shelf (disambiguation).
Shelf
Oak Shelf.png: Infobox image for Minecraft block 'Shelf'
Spruce Shelf.png: Infobox image for Minecraft block 'Shelf'
Birch Shelf.png: Infobox image for Minecraft block 'Shelf'
Jungle Shelf.png: Infobox image for Minecraft block 'Shelf'
Acacia Shelf.png: Infobox image for Minecraft block 'Shelf'
Dark Oak Shelf.png: Infobox image for Minecraft block 'Shelf'
Mangrove Shelf.png: Infobox image for Minecraft block 'Shelf'
Cherry Shelf.png: Infobox image for Minecraft block 'Shelf'
Pale Oak Shelf.png: Infobox image for Minecraft block 'Shelf'
Poplar Shelf.png: Infobox image for Minecraft block 'Shelf'
Bamboo Shelf.png: Infobox image for Minecraft block 'Shelf'
Crimson Shelf.png: Infobox image for Minecraft block 'Shelf'
Warped Shelf.png: Infobox image for Minecraft block 'Shelf'
Invicon Oak Shelf.png: Inventory sprite for Oak Shelf in Minecraft as shown in-game with description: Oak ShelfInvicon Spruce Shelf.png: Inventory sprite for Spruce Shelf in Minecraft as shown in-game with description: Spruce ShelfInvicon Birch Shelf.png: Inventory sprite for Birch Shelf in Minecraft as shown in-game with description: Birch ShelfInvicon Jungle Shelf.png: Inventory sprite for Jungle Shelf in Minecraft as shown in-game with description: Jungle ShelfInvicon Acacia Shelf.png: Inventory sprite for Acacia Shelf in Minecraft as shown in-game with description: Acacia ShelfInvicon Dark Oak Shelf.png: Inventory sprite for Dark Oak Shelf in Minecraft as shown in-game with description: Dark Oak ShelfInvicon Mangrove Shelf.png: Inventory sprite for Mangrove Shelf in Minecraft as shown in-game with description: Mangrove ShelfInvicon Cherry Shelf.png: Inventory sprite for Cherry Shelf in Minecraft as shown in-game with description: Cherry ShelfInvicon Pale Oak Shelf.png: Inventory sprite for Pale Oak Shelf in Minecraft as shown in-game with description: Pale Oak ShelfInvicon Poplar Shelf.png: Inventory sprite for Poplar Shelf in Minecraft as shown in-game with description: Poplar ShelfInvicon Bamboo Shelf.png: Inventory sprite for Bamboo Shelf in Minecraft as shown in-game with description: Bamboo ShelfInvicon Crimson Shelf.png: Inventory sprite for Crimson Shelf in Minecraft as shown in-game with description: Crimson ShelfInvicon Warped Shelf.png: Inventory sprite for Warped Shelf in Minecraft as shown in-game with description: Warped Shelf
Invicon Oak Shelf BE.png: Inventory sprite for Oak Shelf in Minecraft as shown in-game with description: Oak ShelfInvicon Spruce Shelf BE.png: Inventory sprite for Spruce Shelf in Minecraft as shown in-game with description: Spruce ShelfInvicon Birch Shelf BE.png: Inventory sprite for Birch Shelf in Minecraft as shown in-game with description: Birch ShelfInvicon Jungle Shelf BE.png: Inventory sprite for Jungle Shelf in Minecraft as shown in-game with description: Jungle ShelfInvicon Acacia Shelf BE.png: Inventory sprite for Acacia Shelf in Minecraft as shown in-game with description: Acacia ShelfInvicon Dark Oak Shelf BE.png: Inventory sprite for Dark Oak Shelf in Minecraft as shown in-game with description: Dark Oak ShelfInvicon Mangrove Shelf BE.png: Inventory sprite for Mangrove Shelf in Minecraft as shown in-game with description: Mangrove ShelfInvicon Cherry Shelf BE.png: Inventory sprite for Cherry Shelf in Minecraft as shown in-game with description: Cherry ShelfInvicon Pale Oak Shelf BE.png: Inventory sprite for Pale Oak Shelf in Minecraft as shown in-game with description: Pale Oak ShelfInvicon Poplar Shelf BE.png: Inventory sprite for Poplar Shelf in Minecraft as shown in-game with description: Poplar ShelfInvicon Bamboo Shelf BE.png: Inventory sprite for Bamboo Shelf in Minecraft as shown in-game with description: Bamboo ShelfInvicon Crimson Shelf BE.png: Inventory sprite for Crimson Shelf in Minecraft as shown in-game with description: Crimson ShelfInvicon Warped Shelf BE.png: Inventory sprite for Warped Shelf in Minecraft as shown in-game with description: Warped Shelf
View all renders
Renewable Yes
Stackable Yes (64)
Tool SlotSprite Axe Required.png: Sprite image for Axe Required in Minecraft
Blast resistance 3
Hardness 2
Luminous No
Transparent Yes
Waterloggable Yes
Flammable
  • BlockSprite oak-shelf.png: Sprite image for oak-shelf in Minecraft BlockSprite spruce-shelf.png: Sprite image for spruce-shelf in Minecraft BlockSprite birch-shelf.png: Sprite image for birch-shelf in Minecraft BlockSprite jungle-shelf.png: Sprite image for jungle-shelf in Minecraft BlockSprite acacia-shelf.png: Sprite image for acacia-shelf in Minecraft BlockSprite dark-oak-shelf.png: Sprite image for dark-oak-shelf in Minecraft BlockSprite mangrove-shelf.png: Sprite image for mangrove-shelf in Minecraft BlockSprite cherry-shelf.png: Sprite image for cherry-shelf in Minecraft BlockSprite pale-oak-shelf.png: Sprite image for pale-oak-shelf in Minecraft BlockSprite poplar-shelf.png: Sprite image for poplar-shelf in Minecraft BlockSprite bamboo-shelf.png: Sprite image for bamboo-shelf in Minecraft Yes (30)
  • BlockSprite crimson-shelf.png: Sprite image for crimson-shelf in Minecraft BlockSprite warped-shelf.png: Sprite image for warped-shelf in Minecraft No
Catches fire
from lava
  • BlockSprite oak-shelf.png: Sprite image for oak-shelf in Minecraft BlockSprite spruce-shelf.png: Sprite image for spruce-shelf in Minecraft BlockSprite birch-shelf.png: Sprite image for birch-shelf in Minecraft BlockSprite jungle-shelf.png: Sprite image for jungle-shelf in Minecraft BlockSprite acacia-shelf.png: Sprite image for acacia-shelf in Minecraft BlockSprite dark-oak-shelf.png: Sprite image for dark-oak-shelf in Minecraft BlockSprite mangrove-shelf.png: Sprite image for mangrove-shelf in Minecraft BlockSprite cherry-shelf.png: Sprite image for cherry-shelf in Minecraft BlockSprite pale-oak-shelf.png: Sprite image for pale-oak-shelf in Minecraft BlockSprite poplar-shelf.png: Sprite image for poplar-shelf in Minecraft BlockSprite bamboo-shelf.png: Sprite image for bamboo-shelf in Minecraft Yes
  • BlockSprite crimson-shelf.png: Sprite image for crimson-shelf in Minecraft BlockSprite warped-shelf.png: Sprite image for warped-shelf in Minecraft No
Map color
Note block instrument Bass

A shelf is a block that can store and display up to three stacks of items. Using an item slot exchanges its contents with the player's hotbar. Powering a shelf combines its three slots together and makes using it swap everything at once.

Two or three adjacent shelves can merge their slots together if all are powered, which allows for swapping six or nine items at a time, respectively.

Obtaining

Breaking

Shelves can be broken by hand, but using an axe is the fastest.

Block BlockSprite shelf.png: Sprite image for shelf in MinecraftShelf
Hardness 2
Tool
Breaking time (sec)[A]
Default 3 (JE)
3 (BE)
ItemSprite wooden-axe.png: Sprite image for wooden-axe in MinecraftWooden 1.5 (JE)
1.5 (BE)
ItemSprite stone-axe.png: Sprite image for stone-axe in MinecraftStone 0.75 (JE)
0.75 (BE)
ItemSprite copper-axe.png: Sprite image for copper-axe in MinecraftCopper 0.6 (JE)
0.6 (BE)
ItemSprite iron-axe.png: Sprite image for iron-axe in MinecraftIron 0.5 (JE)
0.5 (BE)
ItemSprite diamond-axe.png: Sprite image for diamond-axe in MinecraftDiamond 0.4 (JE)
0.4 (BE)
ItemSprite netherite-axe.png: Sprite image for netherite-axe in MinecraftNetherite 0.35 (JE)
0.35 (BE)
ItemSprite golden-axe.png: Sprite image for golden-axe in MinecraftGolden 0.25 (JE)
0.25 (BE)
Legend
  • 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
  1. ↑ These durations ignore any other influential factors (e.g., Mining Fatigue) and are measured in seconds. For more information, see Breaking § Mining efficiency.

Crafting

Ingredients Crafting recipe
Matching Stripped Log or 
Block of Stripped Bamboo or 
Matching Stripped Stem

Usage

Oak, spruce, and pale oak shelves holding various items. Three pale oak shelves have received a redstone signal.

In Java Edition, shelves cannot be moved by pistons.

Holding items

A shelf can store up to 3 item stacks. Each slot of the shelf can store a full stack of any stackable item, or just one of a non-stackable item. The number of items in the stack is not displayed. The shelf displays all items it contains in front of it, similar to an item frame. Interacting with any of the 3 slots swaps the player's main hand item with the content of that slot if it is not powered by redstone.

Redstone

Two in-game screenshots: the top screenshot taken before and the bottom screenshot taken after. In the before picture, five shelves are placed next to each other in a row, the two shelves on either end are powered and connected, and the shelf in the middle is unpowered. The after picture is identical, except the middle shelf is powered, connecting to the two shelves on the left.
Powered shelves connect with shelves on the left first.

While a shelf is powered by redstone, its front texture changes to show its powered state; when placed next to each other, up to three powered shelves can connect together. Powered shelves prioritize connecting to other shelves on the left.

Powered shelves can be used to quickly swap the contents of a player's hotbar, similar to the Saved Hotbars‌[JE only] function in Creative mode.

  • Interacting with a single powered shelf swaps all its contents with the 3 rightmost slots in the hotbar.
  • Interacting with two connected shelves swaps their contents with the 6 rightmost slots in the hotbar.
  • Interacting with three connected shelves swaps their contents with all 9 slots of the hotbar.

It does not matter which of the connected shelves the player interacts with.

In Bedrock Edition, the shelf activates only on the Input/Consume redstone tick (C-tick).

Comparators

Eight shelves in a row, containing the following items from left-to-right (where 0 represents no item and 1 represents an item): 000, 100, 010, 110, 001, 101, 011, 111; corresponding to signal strengths 0-7 respectively
Shelf signal strength

Shelves can also act as power sources for redstone comparators depending on what slots contain an item.

  • An item in the left slot emits a redstone power of 1.
  • An item in the middle slot emits a redstone power of 2.
  • An item in the right slot emits a redstone power of 4.

If multiple slots contain an item, the comparator outputs the total, up to a maximum power of 7 if all slots are filled.

Comparators only work when the back of the shelf is facing it.

Hoppers and droppers

Shelves can be filled automatically by using either hoppers or droppers. Hoppers can also remove items from a shelf when placed underneath.

Items from a shelf are added and removed from left to right and stack any stackable items into one slot until that slot is full.

Fuel

Overworld shelves can be used as a fuel in furnaces, smelting 1.5 items per shelf.

Nether shelves cannot be used as a fuel in furnaces.

Sounds

Generic

Java Edition:

BlockSprite chiseled-bookshelf.png: Sprite image for chiseled-bookshelf in Minecraft chiseled_bookshelf sound type
SoundClosed captionsSourceDescriptionIdentifierTranslation keyVolumePitchAttenuation
distance
​Block brokenBlocksOnce the block has brokenblock.chiseled_bookshelf.breaksubtitles.block.generic.break​1.00.816
​Block placed​[until: JE 26.4]BlocksWhen the block is placedblock.chiseled_bookshelf.placesubtitles.block.generic.place​1.00.816
​Block breakingBlocksWhile the block is in the process of being brokenblock.chiseled_bookshelf.hitsubtitles.block.generic.hit​0.250.516
​Something falls on a blockEntity-DependentFalling on the block with fall damageblock.chiseled_bookshelf.fallsubtitles.block.generic.fall​0.50.7516
​FootstepsEntity-DependentWalking on the blockblock.chiseled_bookshelf.stepsubtitles.block.generic.footsteps​0.151.016

Bedrock Edition:

BlockSprite chiseled-bookshelf.png: Sprite image for chiseled-bookshelf in Minecraft chiseled_bookshelf sound type
SoundClosed captionsSourceDescriptionIdentifierTranslation keyVolumePitch
​ ?BlocksOnce the block has brokenbreak.chiseled_bookshelf​ ?1.01.0
​ ?BlocksWhen the block is placedplace.chiseled_bookshelf​ ?1.01.0
​ ?BlocksWhile the block is in the process of being brokenhit.chiseled_bookshelf​ ?1.01.0
​ ?PlayersFalling on the block with fall damagestep.chiseled_bookshelf​ ?0.41.0
​ ?PlayersWalking on the blockstep.chiseled_bookshelf​ ?0.21.0
​ ?PlayersJumping from the blockstep.chiseled_bookshelf​ ?0.121.0
​ ?PlayersFalling on the block without fall damagestep.chiseled_bookshelf​ ?0.181.0

Despite shelves using the chiseled_bookshelf sound type for its generic sounds, in Java Edition, the following resource locations also exist: block.shelf.break, block.shelf.place, block.shelf.hit, block.shelf.fall, and block.shelf.step.

Unique

Java Edition:

Sounds
SoundClosed captionsSourceDescriptionIdentifierTranslation keyVolumePitchAttenuation
distance
​Shelf activatesBlocksWhen a shelf is activatedblock.shelf.activatesubtitles.block.shelf.activate​1.01.016
​Shelf deactivatesBlocksWhen a shelf is deactivatedblock.shelf.deactivatesubtitles.block.shelf.deactivate​1.01.016
​Item placed​[until: JE 26.4]BlocksWhen an item is placed in a shelfblock.shelf.place_itemsubtitles.block.shelf.place_item​1.01.016
​Item swapsBlocksWhen an item from the player's inventory is switched with an item in a shelfblock.shelf.single_swapsubtitles.block.shelf.single_swap​1.01.016
​Items swapBlocksWhen multiple items from the player's inventory are switched with multiple items in a shelfblock.shelf.multi_swapsubtitles.block.shelf.multi_swap​1.01.016

Bedrock Edition:

Sounds
SoundClosed captionsSourceDescriptionIdentifierTranslation keyVolumePitch
​ ?BlocksWhen a shelf is activatedblock.shelf.activate​ ?1.01.0
​ ?BlocksWhen a shelf is deactivatedblock.shelf.deactivate​ ?1.01.0
​ ?BlocksWhen an item is placed in a shelfblock.shelf.place_item​ ?1.01.0
​ ?BlocksWhen an item from the player's inventory is switched with an item in a shelfblock.shelf.single_swap​ ?1.01.0
​ ?BlocksWhen multiple items from the player's inventory are switched with multiple items in a shelfblock.shelf.multi_swap​ ?1.01.0
Advertisement Remove ads with Premium →

Data values

ID

Java Edition:

NameIdentifierFormBlock tags Translation key
BlockSprite oak-shelf.png: Sprite image for oak-shelf in Minecraft Oak Shelfoak_shelfBlock & Itemmineable/axe
wooden_shelves		 block.minecraft.oak_shelf
BlockSprite spruce-shelf.png: Sprite image for spruce-shelf in Minecraft Spruce Shelfspruce_shelfBlock & Itemmineable/axe
wooden_shelves		 block.minecraft.spruce_shelf
BlockSprite birch-shelf.png: Sprite image for birch-shelf in Minecraft Birch Shelfbirch_shelfBlock & Itemmineable/axe
wooden_shelves		 block.minecraft.birch_shelf
BlockSprite jungle-shelf.png: Sprite image for jungle-shelf in Minecraft Jungle Shelfjungle_shelfBlock & Itemmineable/axe
wooden_shelves		 block.minecraft.jungle_shelf
BlockSprite acacia-shelf.png: Sprite image for acacia-shelf in Minecraft Acacia Shelfacacia_shelfBlock & Itemmineable/axe
wooden_shelves		 block.minecraft.acacia_shelf
BlockSprite dark-oak-shelf.png: Sprite image for dark-oak-shelf in Minecraft Dark Oak Shelfdark_oak_shelfBlock & Itemmineable/axe
wooden_shelves		 block.minecraft.dark_oak_shelf
BlockSprite mangrove-shelf.png: Sprite image for mangrove-shelf in Minecraft Mangrove Shelfmangrove_shelfBlock & Itemmineable/axe
wooden_shelves		 block.minecraft.mangrove_shelf
BlockSprite cherry-shelf.png: Sprite image for cherry-shelf in Minecraft Cherry Shelfcherry_shelfBlock & Itemmineable/axe
wooden_shelves		 block.minecraft.cherry_shelf
BlockSprite pale-oak-shelf.png: Sprite image for pale-oak-shelf in Minecraft Pale Oak Shelfpale_oak_shelfBlock & Itemmineable/axe
wooden_shelves		 block.minecraft.pale_oak_shelf
BlockSprite poplar-shelf.png: Sprite image for poplar-shelf in Minecraft Poplar Shelfpoplar_shelfBlock & Itemmineable/axe
wooden_shelves		 block.minecraft.poplar_shelf
BlockSprite bamboo-shelf.png: Sprite image for bamboo-shelf in Minecraft Bamboo Shelfbamboo_shelfBlock & Itemmineable/axe
wooden_shelves		 block.minecraft.bamboo_shelf
BlockSprite crimson-shelf.png: Sprite image for crimson-shelf in Minecraft Crimson Shelfcrimson_shelfBlock & Itemmineable/axe
wooden_shelves		 block.minecraft.crimson_shelf
BlockSprite warped-shelf.png: Sprite image for warped-shelf in Minecraft Warped Shelfwarped_shelfBlock & Itemmineable/axe
wooden_shelves		 block.minecraft.warped_shelf
NameIdentifier
BlockSprite shelf.png: Sprite image for shelf in Minecraft Block entityshelf

Bedrock Edition:

NameIdentifierNumeric ID FormItem ID[i 1]Block tags Translation key
BlockSprite oak-shelf.png: Sprite image for oak-shelf in Minecraft Oak Shelfoak_shelf1302Block & Giveable Item[i 2]Identical[i 3]
(Numeric: -1047)		minecraft:is_axe_item_destructible
not_feature_replaceable		 tile.oak_shelf.name
BlockSprite spruce-shelf.png: Sprite image for spruce-shelf in Minecraft Spruce Shelfspruce_shelf1303Block & Giveable Item[i 2]Identical[i 3]
(Numeric: -1048)		minecraft:is_axe_item_destructible
not_feature_replaceable		 tile.spruce_shelf.name
BlockSprite birch-shelf.png: Sprite image for birch-shelf in Minecraft Birch Shelfbirch_shelf1304Block & Giveable Item[i 2]Identical[i 3]
(Numeric: -1049)		minecraft:is_axe_item_destructible
not_feature_replaceable		 tile.birch_shelf.name
BlockSprite jungle-shelf.png: Sprite image for jungle-shelf in Minecraft Jungle Shelfjungle_shelf1305Block & Giveable Item[i 2]Identical[i 3]
(Numeric: -1050)		minecraft:is_axe_item_destructible
not_feature_replaceable		 tile.jungle_shelf.name
BlockSprite acacia-shelf.png: Sprite image for acacia-shelf in Minecraft Acacia Shelfacacia_shelf1306Block & Giveable Item[i 2]Identical[i 3]
(Numeric: -1051)		minecraft:is_axe_item_destructible
not_feature_replaceable		 tile.acacia_shelf.name
BlockSprite dark-oak-shelf.png: Sprite image for dark-oak-shelf in Minecraft Dark Oak Shelfdark_oak_shelf1307Block & Giveable Item[i 2]Identical[i 3]
(Numeric: -1052)		minecraft:is_axe_item_destructible
not_feature_replaceable		 tile.dark_oak_shelf.name
BlockSprite mangrove-shelf.png: Sprite image for mangrove-shelf in Minecraft Mangrove Shelfmangrove_shelf1308Block & Giveable Item[i 2]Identical[i 3]
(Numeric: -1053)		minecraft:is_axe_item_destructible
not_feature_replaceable		 tile.mangrove_shelf.name
BlockSprite cherry-shelf.png: Sprite image for cherry-shelf in Minecraft Cherry Shelfcherry_shelf1309Block & Giveable Item[i 2]Identical[i 3]
(Numeric: -1054)		minecraft:is_axe_item_destructible
not_feature_replaceable		 tile.cherry_shelf.name
BlockSprite pale-oak-shelf.png: Sprite image for pale-oak-shelf in Minecraft Pale Oak Shelfpale_oak_shelf1310Block & Giveable Item[i 2]Identical[i 3]
(Numeric: -1055)		minecraft:is_axe_item_destructible
not_feature_replaceable		 tile.pale_oak_shelf.name
BlockSprite poplar-shelf.png: Sprite image for poplar-shelf in Minecraft Poplar Shelfpoplar_shelf1402Block & Giveable Item[i 2]Identical[i 3]
(Numeric: -1147)		minecraft:is_axe_item_destructible
not_feature_replaceable		 tile.poplar_shelf.name
BlockSprite bamboo-shelf.png: Sprite image for bamboo-shelf in Minecraft Bamboo Shelfbamboo_shelf1311Block & Giveable Item[i 2]Identical[i 3]
(Numeric: -1056)		minecraft:is_axe_item_destructible
not_feature_replaceable		 tile.bamboo_shelf.name
BlockSprite crimson-shelf.png: Sprite image for crimson-shelf in Minecraft Crimson Shelfcrimson_shelf1312Block & Giveable Item[i 2]Identical[i 3]
(Numeric: -1057)		minecraft:is_axe_item_destructible
not_feature_replaceable		 tile.crimson_shelf.name
BlockSprite warped-shelf.png: Sprite image for warped-shelf in Minecraft Warped Shelfwarped_shelf1313Block & Giveable Item[i 2]Identical[i 3]
(Numeric: -1058)		minecraft:is_axe_item_destructible
not_feature_replaceable		 tile.warped_shelf.name
  1. ↑ ID of block's direct item form, which is used in savegame files and addons.
  2. ↑ a b c d e f g h i j k l m Available with /give command.
  3. ↑ a b c d e f g h i j k l m The block's direct item form has the same ID as the block.
NameIdentifier
BlockSprite shelf.png: Sprite image for shelf in Minecraft Block entityShelf

Block states

See also: Block states

Java Edition:

Name Default value Allowed values Description
facingnortheast
north
south
west		The direction the shelf is facing.
Opposite from the direction the player faces when placing it.
poweredfalsetrue
false		True if the shelf is powered.
side_chainunconnectedleft
center
right
unconnected		Which side the shelf is connected to if powered.​
waterloggedfalsetrue
false		Whether there's water in the same place as the shelf.

Bedrock Edition:

Name Default value Allowed values Description
minecraft:cardinal_directionsouthsouth
west
north
east		The direction the shelf is facing.
powered_shelf_type00
1
2
3		​
powered_bitfalsetrue
false		True if the shelf is powered.

Block data

Shelves have block entities associated with them that hold additional data about the block.

Java Edition:

See also: Block entity format
  • [NBT Compound / JSON Object] Block entity data
    • Tags common to all block entities see Template:Nbt inherit/blockentity/template
    • [NBT List / JSON Array] Items: List of items in the shelf. Represents the minecraft:container component.
      • [NBT Compound / JSON Object]: An item, including the slot tag. The valid slot numbers are 0-2.
        • An item stack in a container slot see Template:Nbt inherit/item/template
    • [Boolean] align_items_to_bottom: 1 or 0 (true/false) - if true, items sit near the bottom of the shelf.

Bedrock Edition:

See Bedrock Edition level format/Block entity format.

History

Announcement

May 30, 2026 Poplar shelves were shown in Minecraft Live – May 2026.

Java Edition

Java Edition
1.21.925w31a Added shelves.
Shelved items and blocks sit in the middle.
Shelved items and blocks use the same model display settings as item frames.
25w32a Shelved items and blocks now sit nearer to or at the bottom of the shelf, rather than in the middle.
25w33a Shelved items and blocks now sit in the middle again.
Shelved items and blocks now use separate model display settings.
Shelved blocks and shields are now larger, and items now slightly float in front of the shelves.
Added the align_items_to_bottom block state property, by default set to false, to display items at the bottom of the shelf rather than in the middle.
25w34a The align_items_to_bottom block state has been replaced by an equivalent boolean field for the block entity itself.
25w36a Powered shelves can now connect only to other powered shelves facing the exact same direction.
26.3snap1 Added poplar shelves.

Bedrock Edition

Bedrock Edition
1.21.111Preview 1.21.110.20 Added shelves.
Shelved items and blocks sit in the middle.
Only shelves of the same wood type can connect when powered.
Preview 1.21.110.22 Shelves can now be waterlogged.
A redstone comparator adjacent to a shelf now outputs a signal indicating which slots of the shelf contain items.
Non-solid blocks can no longer be placed on the top, bottom, front or sides of the shelf.
Powered shelves now connect even when they are made of different types of wood.
Preview 1.21.110.23 Shelved items have been slightly adjusted to fit the shelf slots, and the scale of shelved blocks has been halved. Some blocks and items such as banners and shields have kept their original display settings.
Shelved items and blocks now sit nearer to or at the bottom of the shelf, rather than in the middle.
Interacting with an unpowered shelf while in Creative now replaces the shelf item with the player's selected item instead of swapping them.
Preview 1.21.110.24 Updated shelf block model to remove overlapping texture UVs, thus making the texture match Java Edition.
Preview 1.21.110.25 Shelves now produce the same particles as their stripped log counterparts when they break.
Items in the shelf render in the middle of the shelf.
Shelved items now slightly float in front of the shelves, and shelved blocks were restored to their original sizes.
1.21.120Preview 1.21.120.20 Adding or removing redstone power to or from the shelf now emits vibrations.
When a player places/removes/swaps an item on an unpowered shelf, a vibration of frequency 3 is emitted.
When a player places/removes an item on a powered shelf, a vibration of frequency 3 is emitted.
When a player swaps item with one on a powered shelf, a vibration of frequency 6 is emitted.
26.40
Experiment
Drop 3 of 2026		Preview 26.40.27 Added poplar shelves.
26.50Preview 26.50.22 All features from the "Drop 3 of 2026" experiment have been fully implemented.
Advertisement Remove ads with Premium →

Issues

Issues relating to "Shelf" are maintained on the bug tracker. Issues should be reported and viewed there.

Textures

  • Oak shelf
    Oak shelf
  • Birch shelf
    Birch shelf
  • Spruce shelf
    Spruce shelf
  • Jungle shelf
    Jungle shelf
  • Acacia shelf
    Acacia shelf
  • Dark Oak shelf
    Dark Oak shelf
  • Mangrove shelf
    Mangrove shelf
  • Cherry shelf
    Cherry shelf
  • Pale Oak shelf
    Pale Oak shelf
  • Bamboo shelf
    Bamboo shelf
  • Crimson shelf
    Crimson shelf
  • Warped shelf
    Warped shelf

Renders

Mojang screenshots

  • Several shelf variations with copper golem statues
    Several shelf variations with copper golem statues
  • Shelves with the copper chest and copper armor
    Shelves with the copper chest and copper armor
  • Shelves with copper chest
    Shelves with copper chest
  • Shelves in the copper room
    Shelves in the copper room
  • A shelf being used in a machine
    A shelf being used in a machine
  • A wall covered in shelves
    A wall covered in shelves
  • Efe using mangrove shelves
    Efe using mangrove shelves
  • Birch, mangrove, cherry, and oak shelves
    Birch, mangrove, cherry, and oak shelves
  • Shelves in an NPC classroom
    Shelves in an NPC classroom

See also

More in Storage

View all 33 →
LecternLecternA lectern is a block used to display a book and quill or written book for reading. Turning a page triggers a redstone pulse. It also serves as a…Minecart with ChestMinecart with ChestA minecart with chest is a single chest inside a minecart. Unlike regular minecarts, it can be used to store items.Minecart with HopperMinecart with HopperA minecart with hopper is a minecart with a hopper inside. Unlike a normal hopper, it pulls items from containers much more quickly, cannot push items…PortfolioPortfolioA portfolio is an item that can save photos taken with a camera.Shulker BoxShulker BoxA shulker box is a dyeable block that stores items, and, unlike all other storage blocks, keeps its contents in item form when broken.SmokerSmokerA smoker is a block that cooks food twice as quickly as a furnace, but cannot smelt anything else. It also serves as a butcher's job site block.Soul CampfireSoul CampfireSoul campfires are dimmer variants of campfires. Soul campfires deal more damage than normal campfires and have turquoise flames. Just like normal…Trapped ChestTrapped ChestA trapped chest is a type of chest that functions identically to its base counterpart, but has a red-tinted latch and produces redstone power while open.…
Advertisement Remove ads with Premium →

Related mods

Shelf Backport Shelf Backport Mod · 73.4K downloads Shelf Shelf Mod · 37.7K downloads Shelf-It! Shelf-It! Plugin · 21.5K downloads Guide Shelf Guide Shelf Mod · 17.5K downloads
Explore the Minecraft Wiki
Blocks, items, mobs, biomes and game mechanics — all in one place.
Wiki home