Shelf

For the shelf that stores books, see Chiseled Bookshelf. For other uses, see Shelf (disambiguation).
Shelf

Oak Shelf.png: Infobox image for Shelf the block in Minecraft

Spruce Shelf.png: Infobox image for Shelf the block in Minecraft

Birch Shelf.png: Infobox image for Shelf the block in Minecraft

Jungle Shelf.png: Infobox image for Shelf the block in Minecraft

Acacia Shelf.png: Infobox image for Shelf the block in Minecraft

Dark Oak Shelf.png: Infobox image for Shelf the block in Minecraft

Mangrove Shelf.png: Infobox image for Shelf the block in Minecraft

Cherry Shelf.png: Infobox image for Shelf the block in Minecraft

Pale Oak Shelf.png: Infobox image for Shelf the block in Minecraft

Bamboo Shelf.png: Infobox image for Shelf the block in Minecraft

Crimson Shelf.png: Infobox image for Shelf the block in Minecraft

Warped Shelf.png: Infobox image for Shelf the block in Minecraft

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 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 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
Renewable

Yes

Stackable

Yes (64)

Tool
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 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 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

A shelf is a block that can store and display up to three stacks of items.

A powered shelf instantly swaps its three inventory slots with the player's hotbar whenever it is used. Up to three powered shelves can connect together to swap up to nine items at once.

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
BlockSprite oak-planks.png: Sprite image for oak-planks in MinecraftWooden 1.5
BlockSprite cobblestone.png: Sprite image for cobblestone in MinecraftStone 0.75
ItemSprite copper-ingot.png: Sprite image for copper-ingot in MinecraftCopper 0.6
ItemSprite iron-ingot.png: Sprite image for iron-ingot in MinecraftIron 0.5
ItemSprite diamond.png: Sprite image for diamond in MinecraftDiamond 0.4
ItemSprite netherite-ingot.png: Sprite image for netherite-ingot in MinecraftNetherite 0.35
ItemSprite gold-ingot.png: Sprite image for gold-ingot in MinecraftGolden 0.25
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 other influential factors (e.g., Mining Fatigue) and are measured in seconds. For more information, see Breaking § Speed.

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.

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 will emit a redstone power of 1.
  • An item in the middle slot will emit a redstone power of 2.
  • An item in the right slot will emit a redstone power of 4.

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

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 will stack 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.

Note blocks

Shelves can be placed under note blocks to produce "bass" sounds.

Sounds

Generic

Java Edition:

BlockSprite chiseled-bookshelf.png: Sprite image for chiseled-bookshelf in Minecraft chiseled_bookshelf sound type
SoundSubtitlesSourceDescriptionResource locationTranslation keyVolumePitchAttenuation
distance
​Block brokenBlocksOnce the block has brokenblock.chiseled_bookshelf.breaksubtitles.block.generic.break1.00.816
​Block placedBlocksWhen the block is placedblock.chiseled_bookshelf.placesubtitles.block.generic.place1.00.816
​Block breakingBlocksWhile the block is in the process of being brokenblock.chiseled_bookshelf.hitsubtitles.block.generic.hit0.250.516
​Something falls on a blockEntity-DependentFalling on the block with fall damageblock.chiseled_bookshelf.fallsubtitles.block.generic.fall0.50.7516
​FootstepsEntity-DependentWalking on the blockblock.chiseled_bookshelf.stepsubtitles.block.generic.footsteps0.151.016

Bedrock Edition:

BlockSprite chiseled-bookshelf.png: Sprite image for chiseled-bookshelf in Minecraft chiseled_bookshelf sound type
SoundSourceDescriptionResource locationVolumePitch
BlocksOnce the block has brokenbreak.chiseled_bookshelf1.01.0
BlocksWhen the block is placedplace.chiseled_bookshelf1.01.0
BlocksWhile the block is in the process of being brokenhit.chiseled_bookshelf1.01.0
PlayersFalling on the block with fall damagestep.chiseled_bookshelf0.41.0
PlayersWalking on the blockstep.chiseled_bookshelf0.21.0
PlayersJumping from the blockstep.chiseled_bookshelf0.121.0
PlayersFalling on the block without fall damagestep.chiseled_bookshelf0.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
SoundSubtitlesSourceDescriptionResource locationTranslation keyVolumePitchAttenuation
distance
​Shelf activatesBlocksWhen a shelf is activatedblock.shelf.activatesubtitles.block.shelf.activate1.01.016
​Shelf deactivatesBlocksWhen a shelf is deactivatedblock.shelf.deactivatesubtitles.block.shelf.deactivate1.01.016
​Item placedBlocksWhen an item is placed in a shelfblock.shelf.place_itemsubtitles.block.shelf.place_item1.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_swap1.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_swap1.01.016

Bedrock Edition:

Sounds
SoundSourceDescriptionResource locationVolumePitch
BlocksWhen a shelf is activatedblock.shelf.activate1.01.0
BlocksWhen a shelf is deactivatedblock.shelf.deactivate1.01.0
BlocksWhen an item is placed in a shelfblock.shelf.place_item1.01.0
BlocksWhen an item from the player's inventory is switched with an item in a shelfblock.shelf.single_swap1.01.0
BlocksWhen multiple items from the player's inventory are switched with multiple items in a shelfblock.shelf.multi_swap1.01.0

Data values

ID

Java Edition:

NameIdentifierFormBlock tagsTranslation 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 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 tagsTranslation 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 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 Available with /give command.
  3. a b c d e f g h i j k l 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.​[more information needed]
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
[more information needed]
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:

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

Bedrock Edition:

See Bedrock Edition level format/Block entity format.

History

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.
25w34aThe align_items_to_bottom block state has been replaced by an equivalent boolean field for the block entity itself.
25w36aPowered shelves can now only connect to other powered shelves facing the exact same direction.
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.22Shelves 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.25Shelves now produce the same particles as their stripped log counterparts when they break.
Items in the shelf will 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.20Adding 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.

Issues

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

Gallery

Textures

Renders

Mojang screenshots

In other media

See also

Navigation