Block states

This article is about the definition of the block states. For the files that determine block models, see Models § Block states.

Block states are extra pieces of data that further define a block.

List of block states

Anvils

anvil

chipped_anvil

damaged_anvil

Java Edition:

Name	Default value	Allowed values	Description
facing	north	east north south west	An anvil pointing north or south is aligned with its long dimension pointing north–south. An anvil pointing east or west is aligned with its long dimension pointing east–west. This value is 90° clockwise from the direction a player faces while placing an anvil.

Bamboo

bamboo

Java Edition:
Bamboo

Name	Default value	Allowed values	Description
age	0	0 1	The age of the bamboo, if this is 1 the bamboo appears thicker.
leaves	none	large none small	The size of the leaves on this bamboo block.
stage	0	0 1	The stage is incremented at random intervals. At stage 1, bamboo may try to grow more bamboo above it.

Banners

white_banner

orange_banner

magenta_banner

light_blue_banner

yellow_banner

lime_banner

pink_banner

gray_banner

light_gray_banner

cyan_banner

purple_banner

blue_banner

brown_banner

green_banner

red_banner

black_banner

white_wall_banner

orange_wall_banner

magenta_wall_banner

light_blue_wall_banner

yellow_wall_banner

lime_wall_banner

pink_wall_banner

gray_wall_banner

light_gray_wall_banner

cyan_wall_banner

purple_wall_banner

blue_wall_banner

brown_wall_banner

green_wall_banner

red_wall_banner

black_wall_banner

Java Edition:
Floor

Name	Default value	Allowed values	Description
rotation	0	0	The block is facing south.
		1	The block is facing south-southwest.
		2	The block is facing southwest.
		3	The block is facing west-southwest.
		4	The block is facing west.
		5	The block is facing west-northwest.
		6	The block is facing northwest.
		7	The block is facing north-northwest.
		8	The block is facing north.
		9	The block is facing north-northeast.
		10	The block is facing northeast.
		11	The block is facing east-northeast.
		12	The block is facing east.
		13	The block is facing east-southeast.
		14	The block is facing southeast.
		15	The block is facing south-southeast.

Wall

Name	Default value	Allowed values	Description
facing	north	east north south west	The direction the block is facing. For example, a block facing east is attached to a block to its west. Opposite from the direction a player faces when placing the block.

Barrel

Java Edition:

Name	Default value	Allowed values	Description
facing	north	down east north south up west	The direction the barrel is facing.
open	false	false true	Whether the barrel is currently being looked at by a player; changes the texture on the top face.

Beds

white_bed

orange_bed

magenta_bed

light_blue_bed

yellow_bed

lime_bed

pink_bed

gray_bed

light_gray_bed

cyan_bed

purple_bed

blue_bed

brown_bed

green_bed

red_bed

black_bed

Java Edition:

Name	Default value	Allowed values	Description
facing	north	east north south west	The direction the head of the bed is pointing. The same direction the player faces when placing the bed.
occupied	false	false true	True when a player is using the bed.
part	foot	foot head	The half of the bed in the current block.

Bedrock Edition:

Name	Default value	Allowed values	Description
facing_bit	0	0 1 2 3	The direction the head of the bed is pointing. The same direction the player faces when placing the bed.
head_bit	false	false true	If the current block is the head part.
occupied_bit	false	false true	True when a player is using the bed.

Beetroots

Java Edition:

Name	Default value	Allowed values	Description
age	0	0
		1
		2
		3	Fully-grown.

Bell

Java Edition:

Name	Default value	Allowed values	Description
attachment	floor	ceiling double_wall floor single_wall	What the bell is attached to.
facing	north	east north south west	The direction the bell is facing. Opposite from the direction the player faces when placing a bell.

Blast Furnace

Java Edition:

Name	Default value	Allowed values	Description
facing	north	east north south west	The direction the blast furnace's opening faces. The opposite from the direction the player faces while placing the blast furnace.
lit	false	false true	If the blast furnace is lit.

Bedrock Edition:

Name	Default value	Allowed values	Description
facing_direction	2	2 3 4 5	The direction the blast furnace's opening face. Opposite from the direction the player faces when placing a blast furnace.

Bone Block

Java Edition:

Name	Default value	Allowed values	Description
axis	y	x	The bone block is oriented east–west.
		y	The bone block is oriented vertically.
		z	The bone block is oriented north–south.

Bedrock Edition:

Name	Default value	Allowed values	Description
pillar_axis	y	x y z	The axis along which the block is oriented
deprecated	0	0 1 2 3	Unused, has no effect in game.

Brewing Stand

Java Edition:

Name	Default value	Allowed values	Description
has_bottle_0	false	false true	True when a bottle is in slot 1.
has_bottle_1	false	false true	True when a bottle is in slot 2.
has_bottle_2	false	false true	True when a bottle is in slot 3.

Bubble Column

Java Edition:

Name	Default value	Allowed values	Description
drag	true	false true	Determines whether the bubble column is upwards or whirlpool.

Buttons

stone_button

oak_button

spruce_button

birch_button

jungle_button

acacia_button

dark_oak_button

Java Edition:

Name	Default value	Allowed values	Description
face	wall	ceiling floor wall	The face of the block it's placed on. Floor is on top of a block, ceiling is on the bottom, and wall is on one of its sides.
facing	north	east north south west	The direction it's facing. Opposite to the direction the player is facing if placed on the side of a block.
powered	false	false true	If true, the button is currently activated.

Cactus

Name	Default value	Allowed values	Description
age	0	0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15	A freshly-planted cactus – and a cactus which has just grown cactus above it – each have an age of 0. The age is incremented at random intervals. At age 15, a cactus may try to grow more cactus above it.

Campfire

Java Edition:

Name	Default value	Allowed values	Description
facing	north	east north south west	The direction the campfire is facing.
lit	true	false true	Whether the campfire is lit.
signal_fire	false	false true	Whether the campfire has a hay bale below it.
waterlogged	false	false true	Whether the campfire is waterlogged

Cake

Java Edition:

Name	Default value	Allowed values	Description
bites	0	0 1 2 3 4 5 6	Number of bites taken from the cake.

Carrots

Java Edition:

Name	Default value	Allowed values	Description
age	0	0 1
		2 3
		4 5 6
		7	Fully-grown.

Carved Pumpkin

Java Edition:

Name	Default value	Allowed values	Description
facing	north	east north south west	The direction the pumpkin's carved face is facing. The opposite from the direction the player faces while placing the pumpkin.

Bedrock Edition:

Name	Default value	Allowed values	Description
direction	0	0 1 2 3	The direction the pumpkin is facing.

In Java Edition, this block state only applies to carved pumpkins. In Bedrock Edition, it also applies to un-carved pumpkins.^{[more information needed]}

Cauldron

Java Edition:

Name	Default value	Allowed values	Description
level	0	0 1 2 3	Water level in a cauldron, 0 is empty and 3 is full.

Chests

chest

trapped_chest

Java Edition:

Name	Default value	Allowed values	Description
facing	north	east north south west	The direction the chest's latch is on. Opposite from the direction the player faces when placing a chest.
type	single	left right single	The direction the chest has a connection with.
waterlogged	false	false true	Whether or not there's water in the same place as this chest.

Bedrock Edition:

Name	Default value	Allowed values	Description
facing_direction	2	2 3 4 5	The direction the chest's latch is on. Opposite from the direction the player faces when placing a chest.

Ender Chest

Java Edition:

Name	Default value	Allowed values	Description
facing	north	east north south west	The direction the ender chest's latch is on. Opposite from the direction the player faces when placing an ender chest.
waterlogged	false	false true	Whether or not there's water in the same place as this ender chest.

Bedrock Edition:

Name	Default value	Allowed values	Description
facing_direction	2	2 3 4 5	The direction the chest's latch is on. Opposite from the direction the player faces when placing a chest.

Chorus Flower

Java Edition:

Name	Default value	Allowed values	Description
age	0	0 1 2 3 4	A freshly-planted chorus flower starts at age 0. The age is incremented when a chorus flower turns horizontally and/or generates additional chorus flowers on the same plant.
		5	At age 5, the chorus flower will not grow anymore. A chorus flower can become age 5 at any time.

Chorus Plant

Java Edition:

Name	Default value	Allowed values	Description
down	false	false true	When true, the plant extends out from the center of the plant-block down.
east	false	false true	When true, the plant extends out from the center of the plant-block to the east.
north	false	false true	When true, the plant extends out from the center of the plant-block to the north.
south	false	false true	When true, the plant extends out from the center of the plant-block to the south.
up	false	false true	When true, the plant extends out from the center of the plant-block up.
west	false	false true	When true, the plant extends out from the center of the plant-block to the west.

Cocoa

Java Edition:

Name	Default value	Allowed values	Description
age	0	0 1 2	The stage of the pod's growth, 2 is fully grown.
facing	north	east north south west	The direction from the cocoa bean to the log. The direction the player faces when placing the cocoa.

Command Blocks

command_block

chain_command_block

repeating_command_block

Java Edition:

Name	Default value	Allowed values	Description
conditional	false	false true	True if the command block is in conditional mode.
facing	north	down east north south up west	The direction the command block is pointing.

Composter

Java Edition:

Name	Default value	Allowed values	Description
level	0	0 1 2 3 4 5 6 7 8	When at level 8, bone meal is able to be collected from the composter.

Conduit

Java Edition:

Name	Default value	Allowed values	Description
waterlogged	true	false true	Whether or not there's water in the same place as this conduit.

Daylight Detector

Java Edition:

Name	Default value	Allowed values	Description
inverted	false	false true	If true, the daylight detector is inverted.
power	0	0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15	The current redstone power level produced by the daylight sensor.

Dispenser and Dropper

Java Edition:

Name	Default value	Allowed values	Description
facing	north	down east north south up west	The direction in which contents are shot or dropped. The opposite from the direction the player faces while placing the block.
triggered	false	false true	True if this block is activated.

Bedrock Edition:

Name	Default value	Allowed values	Description
facing_direction	0	0 1 2 3 4 5 6 7	The direction in which contents are shot or dropped. The opposite from the direction the player faces while placing the block.
triggered_bit	false	false true	True if this block is activated.

Doors

iron_door

oak_door

spruce_door

birch_door

jungle_door

acacia_door

dark_oak_door

Java Edition:

Name	Default value	Allowed values	Description
facing	north	east north south west	The direction the door's "inside" is facing. The direction the player faces while placing the door. For example, a door facing east will occupy the west part of its block when closed.
half	lower	lower upper	Identifies which part of the door the block is.
hinge	left	left right	Identifies the side the hinge is on (when facing the same direction as the door's inside).
open	false	false true	True if the door is currently open.
powered	false	false true	True if the door is currently powered by redstone.

End Portal Frame

Java Edition:

Name	Default value	Allowed values	Description
eye	false	false true	If true, the portal frame block contains an eye of ender.
facing	north	east north south west	The direction of the end portal frame block. The opposite from the direction the player faces while placing the block. In order to activate a portal, all 12 blocks must be facing inward; for example, the northern three blocks must all face south.

End Rod

Java Edition:

Name	Default value	Allowed values	Description
facing	up	down east north south up west	The direction to the end rod, from the block it is attached to; also the direction the white end points. Opposite from the direction the player faces when placing an end rod, and opposite from the purple end.

Farmland

Java Edition:

Name	Default value	Allowed values	Description
moisture	0	0 1 2 3 4 5 6	Not fully-hydrated.
		7	Fully-hydrated.

Fences

oak_fence

spruce_fence

birch_fence

jungle_fence

acacia_fence

dark_oak_fence

nether_brick_fence

Java Edition:

Name	Default value	Allowed values	Description
east	false	false true	When true, the fence extends from the center post to the east.
north	false	false true	When true, the fence extends from the center post to the north.
south	false	false true	When true, the fence extends from the center post to the south.
waterlogged	false	false true	Whether or not there's water in the same place as this fence.
west	false	false true	When true, the fence extends from the center post to the west.

Fence Gates

oak_fence_gate

spruce_fence_gate

birch_fence_gate

jungle_fence_gate

acacia_fence_gate

dark_oak_fence_gate

Java Edition:

Name	Default value	Allowed values	Description
facing	north	east north south west	For an open gate, the direction the gates swing open. For a closed gate, the direction the player was facing when the gate was placed, or the last direction the gates have swung.
in_wall	false	false true	If true, the gate is lowered by three pixels, to accommodate attaching more cleanly with walls.
open	false	false true	If true, the gate is opened.
powered	false	false true	If true, the gate is receiving redstone power.

Fire

Java Edition:

Name	Default value	Allowed values	Description
age	0	0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15	Newly-placed fire has an age of 0, and has a 1⁄3 chance of incrementing with each block tick. This factor affects how the fire extinguishes.
east	false	false true	When true, fire texture shows on that face of the block to the east; false if there's a block below this fire.
north	false	false true	When true, fire texture shows on that face of the block to the north; false if there's a block below this fire.
south	false	false true	When true, fire texture shows on that face of the block to the south; false if there's a block below this fire.
up	false	false true	When true, fire texture shows on that face of the block above; false if there's a block below this fire.
west	false	false true	When true, fire texture shows on that face of the block to the west; false if there's a block below this fire.

Bedrock Edition:

Name	Default value	Allowed values	Description
age	0	0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15	Newly-placed fire has an age of 0, and has a 1⁄3 chance of incrementing with each block tick. This factor affects how the fire extinguishes.

Frosted Ice

Java Edition:

Name	Default value	Allowed values	Description
age	0	0	Freshly-generated ice.
		1 2 3	Ice with spreading cracks.

Furnace

Java Edition:

Name	Default value	Allowed values	Description
facing	north	east north south west	The direction the furnace opening faces. The opposite from the direction the player faces while placing the furnace.
lit	false	false true	If the furnace is lit.

Bedrock Edition:

Name	Default value	Allowed values	Description
facing_direction	2	2 3 4 5	The direction the furnace opening faces. Opposite from the direction the player faces when placing a furnace.

Glass Panes

glass_pane

white_stained_glass_pane

orange_stained_glass_pane

magenta_stained_glass_pane

light_blue_stained_glass_pane

yellow_stained_glass_pane

lime_stained_glass_pane

pink_stained_glass_pane

gray_stained_glass_pane

light_gray_stained_glass_pane

cyan_stained_glass_pane

purple_stained_glass_pane

blue_stained_glass_pane

brown_stained_glass_pane

green_stained_glass_pane

red_stained_glass_pane

black_stained_glass_pane

Java Edition:

Name	Default value	Allowed values	Description
east	false	false true	When true, the glass pane extends from the center post to the east.
north	false	false true	When true, the glass pane extends from the center post to the north.
south	false	false true	When true, the glass pane extends from the center post to the south.
waterlogged	false	false true	Whether or not there's water in the same place as this glass pane.
west	false	false true	When true, the glass pane extends from the center post to the west.

Glazed Terracotta

white_glazed_terracotta

orange_glazed_terracotta

magenta_glazed_terracotta

light_blue_glazed_terracotta

yellow_glazed_terracotta

lime_glazed_terracotta

pink_glazed_terracotta

gray_glazed_terracotta

light_gray_glazed_terracotta

cyan_glazed_terracotta

purple_glazed_terracotta

blue_glazed_terracotta

brown_glazed_terracotta

green_glazed_terracotta

red_glazed_terracotta

black_glazed_terracotta

Java Edition:

Name	Default value	Allowed values	Description
facing	north	east north south west	The opposite from the direction the player faces while placing the block.

Grass Block, Mycelium, and Podzol

Java Edition:

Name	Default value	Allowed values	Description
snowy	false	false true	If true, the block uses a snowy side and top texture. In-game, this is true when a snow block or snow is on top.

Grindstone

Java Edition:

Name	Default value	Allowed values	Description
face	wall	ceiling floor wall	What the grindstone is attached to.
facing	north	east north south west	The direction the grindstone is facing. Opposite from the direction the player faces when placing a grindstone on the floor or ceiling.

Hay Bale

Java Edition:

Name	Default value	Allowed values	Description
axis	y	x	The hay block is oriented east–west.
		y	The hay block is oriented vertically.
		z	The hay block is oriented north–south.

Bedrock Edition:

Name	Default value	Allowed values	Description
pillar_axis	y	x y z	The axis along which the block is oriented
deprecated	0	0 1 2 3	Unused, has no effect in game.

Hopper

Java Edition:

Name	Default value	Allowed values	Description
enabled	true	false true	True if hopper can move items to and from its inventory. When the hopper is being powered by redstone current, this is set to false.
facing	down	down east north south west	The direction the hopper's output points. The hopper will push items into containers in this direction only.

Iron Bars

Java Edition:

Name	Default value	Allowed values	Description
east	false	false true	When true, the iron bars extends from the center post to the east.
north	false	false true	When true, the iron bars extends from the center post to the north.
south	false	false true	When true, the iron bars extends from the center post to the south.
waterlogged	false	false true	Whether or not there's water in the same place as these iron bars.
west	false	false true	When true, the iron bars extends from the center post to the west.

Jigsaw Block

Java Edition:

Name	Default value	Allowed values	Description
facing	up	down east north south up west	The direction the jigsaw block is facing.

Jack o'Lantern

Java Edition:

Name	Default value	Allowed values	Description
facing	north	east north south west	The direction the jack o'lantern's carved face is facing. The opposite from the direction the player faces while placing the jack o'lantern.

Bedrock Edition:

Name	Default value	Allowed values	Description
direction	0	0 1 2 3	The direction the jack o' lantern is facing.

Jukebox

Java Edition:

Name	Default value	Allowed values	Description
has_record	false	false true	True when the jukebox contains a music disc.

Kelp

Java Edition:
Top

Name	Default value	Allowed values	Description
age	0	0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25	A freshly-planted kelp starts with a random age between 0 and 24. Below age 25, a kelp may try go grow more kelp above it with the same age value incremented by one. Kelp stops growing at age 25.

Ladder

Java Edition:

Name	Default value	Allowed values	Description
facing	north	east north south west	The direction from the block the ladder is attached to, to the ladder.
waterlogged	false	false true	Whether or not there's water in the same place as this ladder.

Lantern

Java Edition:

Name	Default value	Allowed values	Description
hanging	false	false true	If the lantern is hanging from a block.

Large Flowers

Java Edition:
Sunflower, lilac, rose bush, and peony

Name	Default value	Allowed values	Description
half	lower	lower upper	The half of the plant contained in this block.

Bedrock Edition:
All small flowers except dandelion

Name	Default value	Allowed values	Description
flower_type	poppy	allium cornflower houstonia lily_of_the_valley orchid oxeye poppy tulip_orange tulip_pink tulip_red tulip_white	The flower type.

Sunflower, lilac, rose bush, and peony

Name	Default value	Allowed values	Description
double_flower_type	sunflower	fern grass paeonia rose sunflower syringa	The flower type.
upper_block_bit	false	false true	If the upper half of the plant contained in this block.

Lava

Java Edition:

Name	Default value	Allowed values	Description
level	0	0	Lava source block.
		1 2 3 4 5 6 7	The distance from a lava source or a falling lava. In the End and Overworld, only 2, 4 and 6 are used.
		8 9 10 11 12 13 14 15	Falling lava. This level is equal to the falling lava above, and if it's non-falling, equal to 8 plus the level of the non-falling lava above it.

Bedrock Edition:
Lava and flowing lava

Name	Default value	Allowed values	Description
liquid_depth	0	0	Lava source block.
		1 2 3 4 5 6 7	The distance from a lava source or a falling lava. In the End and Overworld, only 2, 4 and 6 are used.
		8 9 10 11 12 13 14 15	Falling lava. This level is equal to the falling lava above, and if it's non-falling, equal to 8 plus the level of the non-falling lava above it.

Leaves

oak_leaves

spruce_leaves

birch_leaves

jungle_leaves

acacia_leaves

dark_oak_leaves

Java Edition:

Name	Default value	Allowed values	Description
distance	7	1 2 3 4 5 6 7	How far away this block is from the appropriate wood type.
persistent	false	false true	If the block will stay regardless of having no wood nearby.

Bedrock Edition:
Leaves

Name	Default value	Allowed values	Description
old_leaf_type	oak	oak	Oak Leaves
		spruce	Spruce Leaves
		birch	Birch Leaves
		jungle	Jungle Leaves
persistent_bit	false	false true	If the block will stay regardless of having no wood nearby.
update_bit	false	false true	If the block will check for nearby wood.

Leaves2

Name	Default value	Allowed values	Description
new_leaf_type	acacia	acacia	Acacia Leaves
		dark_oak	Dark Oak Leaves
persistent_bit	false	false true	If the block will stay regardless of having no wood nearby.
update_bit	false	false true	If the block will check for nearby wood.

Lectern

Java Edition:

Name	Default value	Allowed values	Description
facing	north	east north south west	The direction the lectern is facing. Opposite from the direction the player faces when placing a lectern.
has_book	false	false true	If the lectern currently has a book.
powered	false	false true	If the lectern is currently outputting a redstone signal.

Lever

Java Edition:

Name	Default value	Allowed values	Description
face	wall	ceiling floor wall	The face of the block it's placed on. Floor is on top of a block, ceiling is on the bottom, and wall is on one of its sides.
facing	north	east north south west	The direction it's facing. Opposite to the direction the player is facing if placed on the side of a block.
powered	false	false true	If true, the lever is currently activated.

Logs

oak_log

spruce_log

birch_log

jungle_log

acacia_log

dark_oak_log

stripped_oak_log

stripped_spruce_log

stripped_birch_log

stripped_jungle_log

stripped_acacia_log

stripped_dark_oak_log

Java Edition:

Name	Default value	Allowed values	Description
axis	y	x	The log is oriented east–west.
		y	The log is oriented vertically.
		z	The log is oriented north–south.

Bedrock Edition:
Log

Name	Default value	Allowed values	Description
direction	0	0	The log is oriented vertically.
		1	The log is oriented east–west.
		2	The log is oriented north–south.
old_log_type	oak	oak	Oak Log
		spruce	Spruce Log
		birch	Birch Log
		jungle	Jungle Log

Log2

Name	Default value	Allowed values	Description
direction	0	0	The log is oriented vertically.
		1	The log is oriented east–west.
		2	The log is oriented north–south.
new_log_type	acacia	acacia	Acacia Log
		dark_oak	Dark Oak Log

Loom

Java Edition:

Name	Default value	Allowed values	Description
facing	north	east north south west	The direction the loom is facing. Opposite from the direction the player faces when placing a loom.

Melon Stem

Java Edition:
Growing

Name	Default value	Allowed values	Description
age	0	0	A newly-planted stem.
		1 2 3 4 5 6	Intermediate growth stages of the stem.
		7	A fully-mature stem, capable of producing melons.

Attached

Name	Default value	Allowed values	Description
facing	north	east north south west	The direction from the stem to the melon.

Mob heads

skeleton_skull

wither_skeleton_skull

zombie_head

player_head

creeper_head

dragon_head

skeleton_wall_skull

wither_skeleton_wall_skull

zombie_wall_head

player_wall_head

creeper_wall_head

dragon_wall_head

Java Edition:
Floor

Name	Default value	Allowed values	Description
rotation	0	0	The block is facing south.
		1	The block is facing south-southwest.
		2	The block is facing southwest.
		3	The block is facing west-southwest.
		4	The block is facing west.
		5	The block is facing west-northwest.
		6	The block is facing northwest.
		7	The block is facing north-northwest.
		8	The block is facing north.
		9	The block is facing north-northeast.
		10	The block is facing northeast.
		11	The block is facing east-northeast.
		12	The block is facing east.
		13	The block is facing east-southeast.
		14	The block is facing southeast.
		15	The block is facing south-southeast.

Wall

Name	Default value	Allowed values	Description
facing	north	east north south west	The direction the head is facing. Opposite from the direction a player is facing when placing it.

Mushroom Blocks

brown_mushroom_block

red_mushroom_block

mushroom_stem

Java Edition:

Name	Default value	Allowed values	Description
east	true	false true	/ If true, the east face has the cap/stem texture. If false, it has the pores texture instead.
down	true	false true	/ If true, the bottom face has the cap/stem texture. If false, it has the pores texture instead.
north	true	false true	/ If true, the north face has the cap/stem texture. If false, it has the pores texture instead.
south	true	false true	/ If true, the south face has the cap/stem texture. If false, it has the pores texture instead.
up	true	false true	/ If true, the top face has the cap/stem texture. If false, it has the pores texture instead.
west	true	false true	/ If true, the west face has the cap/stem texture. If false, it has the pores texture instead.

Nether Wart

Java Edition:

Name	Default value	Allowed values	Description
age	0	0
		1 2
		3	Fully grown.

Nether Portal

Java Edition:

Name	Default value	Allowed values	Description
axis	x	x	The portal's long edge runs east–west.
		z	The portal's long edge runs north–south.

Note Block

Java Edition:

Name	Default value	Allowed values	Description
instrument	harp	banjo basedrum bass bell bit chime cow_bell didgeridoo flute guitar harp hat iron_xylophone pling snare xylophone	The instrument of the note block.
note	0	0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24	The pitch of the note block
powered	false	false true	True if the note block is currently activated.

Observer

Java Edition:

Name	Default value	Allowed values	Description
facing	south	down east north south up west	The direction the observer is observing. The same direction the player faces when placing the block.
powered	false	false true	True while the observer is observing a change and emitting a pulse.

Pistons

piston

sticky_piston

Java Edition:

Name	Default value	Allowed values	Description
extended	false	false true	If true, the piston is extended.
facing	north	down east north south up west	The direction the piston head is pointing. The opposite from the direction the player faces while placing the piston.

Bedrock Edition:

Name	Default value	Allowed values	Description
facing_direction	0	0 1 2 3 4 5 6 7	The direction the piston head is pointing. The opposite from the direction the player faces while placing the piston.

Moving Piston

Java Edition:

Name	Default value	Allowed values	Description
facing	north	down east north south up west	The direction the block is being pushed by the piston.
type	normal	normal sticky	What piston base this has.

Piston Head

Java Edition:

Name	Default value	Allowed values	Description
facing	north	down east north south up west	The direction the piston head is pointing.
short	false	false true	If true, the piston arm is shorter than usual, by 4 pixels.
type	normal	normal sticky	The type of piston head.

Potatoes

Java Edition:

Name	Default value	Allowed values	Description
age	0	0 1
		2 3
		4 5 6
		7	Fully-grown.

Pressure Plates

stone_pressure_plate

oak_pressure_plate

spruce_pressure_plate

birch_pressure_plate

jungle_pressure_plate

acacia_pressure_plate

dark_oak_pressure_plate

heavy_weighted_pressure_plate

light_weighted_pressure_plate

Java Edition:
Stone and wooden pressure plates

Name	Default value	Allowed values	Description
powered	false	false true	True if pressure plate is depressed, providing power.

Weighted pressure plates

Name	Default value	Allowed values	Description
power	0	0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15	Specifies the redstone power level currently being produced by the weighted pressure plate.

Pumpkin Stem

Java Edition:
Growing

Name	Default value	Allowed values	Description
age	0	0	A newly-planted stem.
		1 2 3 4 5 6	Intermediate growth stages of the stem.
		7	A fully-mature stem, capable of producing pumpkins.

Attached

Name	Default value	Allowed values	Description
facing	north	east north south west	The direction from the stem to the pumpkin.

Purpur and Quartz Pillar

Java Edition:

Name	Default value	Allowed values	Description
axis	y	x	The pillar is oriented east–west.
		y	The pillar is oriented vertically.
		z	The pillar is oriented north–south.

Bedrock Edition:

Name	Default value	Allowed values	Description
chisel_type	default	default	The main block type.
		chiseled	The chiseled type.
		lines	The pillar type.
		smooth	The smooth type.
pillar_axis	y	x y z	The axis along which the block is oriented. Normally only applies to the pillar type.

Rails

Rail

Java Edition:

Name	Default value	Allowed values	Description
shape	north_south	east_west north_east north_south north_west south_east south_west	The two directions a rail connects to. For example, a south_east rail is a curved rail that connects to the south and to the east.
		ascending_east ascending_north ascending_south ascending_west	A rail that ascends toward the direction noted. For example, an ascending_west rail is a straight rail that goes upward from the east toward the west.

Activator Rail, Detector Rail, and Powered Rail

Java Edition:

Name	Default value	Allowed values	Description
powered	false	false true	True if rail is activated.
shape	north_south	east_west north_south	Specifies the rail's orientation.
		ascending_east ascending_north ascending_south ascending_west	A rail that ascends toward the direction noted. For example, an ascending_west rail is a straight rail that goes upward from the east toward the west.

Bedrock Edition:

Name	Default value	Allowed values	Description
rail_data_bit	false	false true	True if rail is activated.
rail_direction	0	0 1 2 3 4 5 6 7	The direction the rail is facing.

Redstone Comparator

Java Edition:

Name	Default value	Allowed values	Description
facing	north	east north south west	The direction from the output side to the input side of the comparator, or the opposite from the direction the player faces while placing the comparator.
mode	compare	compare subtract	Specifies the current mode of the redstone comparator.
powered	false	false true	True if the redstone comparator is being powered.

Redstone Dust

Java Edition:

Name	Default value	Allowed values	Description
east	none	none side up	The way redstone dust connects to the east, side can also mean down.
north	none	none side up	The way redstone dust connects to the north, side can also mean down.
power	0	0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15	The redstone dust's current power level.
south	none	none side up	The way redstone dust connects to the south, side can also mean down.
west	none	none side up	The way redstone dust connects to the west, side can also mean down.

Bedrock Edition:

Name	Default value	Allowed values	Description
redstone_signal	0	0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15	The redstone dust's current power level.

Redstone Lamp

Java Edition:

Name	Default value	Allowed values	Description
lit	false	false true	If the redstone lamp is lit.

Redstone Ore

Java Edition:

Name	Default value	Allowed values	Description
lit	false	false true	If the redstone ore is lit.

Redstone Repeater

Java Edition:

Name	Default value	Allowed values	Description
delay	1	1 2 3 4	The redstone repeater's delay in redstone ticks.
facing	north	east north south west	The direction from the output side to the input side of a repeater. The opposite from the direction the player faces while placing the repeater.
locked	false	false true	True if the repeater is currently locked.
powered	false	false true	If the redstone repeater is lit.

Redstone Torch

Java Edition:
Floor

Name	Default value	Allowed values	Description
lit	true	false true	If the torch is lit.

Wall

Name	Default value	Allowed values	Description
facing	north	east north south west	The direction the top of the torch is facing.
lit	true	false true	If the torch is lit.

Bedrock Edition:

Name	Default value	Allowed values	Description
torch_facing_direction	top	east north south top unknown west	The direction the top of the torch is facing.

Saplings

oak_sapling

spruce_sapling

birch_sapling

jungle_sapling

acacia_sapling

dark_oak_sapling

Java Edition:

Name	Default value	Allowed values	Description
stage	0	0 1	Specifies the sapling's growth stage.

Bedrock Edition:

Name	Default value	Allowed values	Description
age_bit	false	false true	Specifies the sapling's growth stage.
sapling_type	oak	oak	Oak Sapling
		spruce	Spruce Sapling
		birch	Birch Sapling
		jungle	Jungle Sapling
		acacia	Acacia Sapling
		dark_oak	Dark Oak Sapling

Scaffolding

Java Edition:

Name	Default value	Allowed values	Description
bottom	false	false true	If this scaffolding is floating.
distance	7	0 1 2 3 4 5 6 7	The distance from a center scaffolding horizontally. If it is 7, it will turn into a falling block entity.
waterlogged	false	false true	Whether or not there's water in the same place as the scaffolding.

Sea Pickle

Java Edition:

Name	Default value	Allowed values	Description
pickles	1	1 2 3 4	Number of pickles.
waterlogged	true	false true	Whether or not there's water in the same place as these pickles.

Shulker Boxes

shulker_box

white_shulker_box

orange_shulker_box

magenta_shulker_box

light_blue_shulker_box

yellow_shulker_box

lime_shulker_box

pink_shulker_box

gray_shulker_box

light_gray_shulker_box

cyan_shulker_box

purple_shulker_box

blue_shulker_box

brown_shulker_box

green_shulker_box

red_shulker_box

black_shulker_box

Java Edition:

Name	Default value	Allowed values	Description
facing	up	down east north south up west	The direction the shulker box is pointing. The opposite from the direction the player faces while placing the shulker box.

Sign

Java Edition:
Floor

Name	Default value	Allowed values	Description
rotation	0	0	The block is facing south.
		1	The block is facing south-southwest.
		2	The block is facing southwest.
		3	The block is facing west-southwest.
		4	The block is facing west.
		5	The block is facing west-northwest.
		6	The block is facing northwest.
		7	The block is facing north-northwest.
		8	The block is facing north.
		9	The block is facing north-northeast.
		10	The block is facing northeast.
		11	The block is facing east-northeast.
		12	The block is facing east.
		13	The block is facing east-southeast.
		14	The block is facing southeast.
		15	The block is facing south-southeast.
waterlogged	false	false true	Whether or not there's water in the same place as this sign.

Wall

Name	Default value	Allowed values	Description
facing	north	east north south west	The direction the block is facing. For example, a block facing east is attached to a block to its west. Opposite from the direction a player faces when placing the block.
waterlogged	false	false true	Whether or not there's water in the same place as this sign.

Slabs

stone_slab

sandstone_slab

petrified_oak_slab

cobblestone_slab

brick_slab

stone_brick_slab

nether_brick_slab

quartz_slab

red_sandstone_slab

prismarine_slab

prismarine_brick_slab

dark_prismarine_slab

oak_slab

spruce_slab

birch_slab

jungle_slab

acacia_slab

dark_oak_slab

prismarine_slab

prismarine_brick_slab

dark_prismarine_slab

Java Edition:

Name	Default value	Allowed values	Description
type	bottom	bottom top	Where the slab is within its block.
		double	The block is a double slab.
waterlogged	false	false true	Whether or not there's water in the same place as this slab.

Bedrock Edition:
Stone slab and double stone slab

Name	Default value	Allowed values	Description
stone_slab_type	smooth_stone	brick cobblestone nether_brick quartz sandstone smooth_stone stone_brick wood	The type of slab this is.
top_slot_bit	false	false true	If this slab is an upper slab.

Wood slab and double wood slab

Name	Default value	Allowed values	Description
top_slot_bit	false	false true	If this slab is an upper slab.
wood_type	oak	acacia birch dark_oak jungle oak spruce	The type of slab this is.

Stone slab 2 and double stone slab 2

Name	Default value	Allowed values	Description
stone_slab_type_2	red_sandstone	mossy_cobblestone prismarine_brick prismarine_dark prismarine_rough purpur red_nether_brick red_sandstone smooth_sandstone	The type of slab this is.
top_slot_bit	false	false true	If this slab is an upper slab.

Stone slab 3 and double stone slab 3

Name	Default value	Allowed values	Description
stone_slab_type_3	end_stone_brick	andesite diorite end_stone_brick granite polished_andesite polished_diorite polished_granite smooth_red_sandstone	The type of slab this is.
top_slot_bit	false	false true	If this slab is an upper slab.

Stone slab 4 and double stone slab 4

Name	Default value	Allowed values	Description
stone_slab_type_4	mossy_stone_brick	cut_red_sandstone cut_sandstone mossy_stone_brick smooth_quartz stone	The type of slab this is.
top_slot_bit	false	false true	If this slab is an upper slab.

Smoker

Java Edition:

Name	Default value	Allowed values	Description
facing	north	east north south west	The direction the smoker opening faces. The opposite from the direction the player faces while placing the smoker.
lit	false	false true	If the smoker is lit.

Bedrock Edition:

Name	Default value	Allowed values	Description
facing_direction	2	2 3 4 5	The direction the smoker opening faces. The opposite from the direction the player faces while placing the smoker.

Snow

Java Edition:

Name	Default value	Allowed values	Description
layers	1	1 2 3 4 5 6 7 8	The number of layers thick. Each layer adds two pixels to the block height, and each layer after the first adds two pixels to the collision box.

Bedrock Edition:

Name	Default value	Allowed values	Description
height	0	0 1 2 3 4 5 6 7	The number of layers in addition to the bottom layer.
covered_bit	0	0 1	[more information needed]

Stairs

• acacia_stairs

• birch_stairs

• brick_stairs

• dark_oak_stairs

• jungle_stairs

• nether_brick_stairs

• oak_stairs

• purpur_stairs

• quartz_stairs

• red_sandstone_stairs

• sandstone_stairs

• spruce_stairs

• stone_brick_stairs

• cobblestone_stairs

• prismarine_stairs

• prismarine_brick_stairs

• dark_prismarine_stairs

Java Edition:

Name	Default value	Allowed values	Description
facing	north	east north south west	The direction the stairs' full-block side faces. When placed in-game by a player, this matches the direction the player faces.
half	bottom	bottom top	Top if the stairs are upside-down.
shape	straight	inner_left inner_right outer_left outer_right straight	"straight" is the default stairs shape. "inner" is an "inside corner" stair shape, with two full-block and two stair-shaped side faces. "outer" is an "outside corner" stair shape, with two stair-shaped and two half-block side faces. "left" and "right" specify in which direction is the higher part of the step.
waterlogged	false	false true	Whether or not there's water in the same place as these stairs.

Bedrock Edition:

Name	Default value	Allowed values	Description
upside_down_bit	false	false true	True if the stairs are upside-down.
weirdo_direction	0	0 1 2 3	The direction the stairs' full-block side faces. When placed in-game by a player, this matches the direction the player faces.

Stonecutter

Java Edition:

Name	Default value	Allowed values	Description
facing	north	east north south west	The direction the stonecutter is facing. Opposite from the direction the player faces when placing a stonecutter.

Structure Block

Java Edition:
Structure block

Name	Default value	Allowed values	Description
mode	data	corner	Corner Structure Block
		data	Data Structure Block
		load	Load Structure Block
		save	Save Structure Block

Sugar Cane

Name	Default value	Allowed values	Description
age	0	0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15	A freshly-planted cane – and a cane which has just grown cane above it – each have an age of 0. The age is incremented at random intervals. At age 15, a cane may try to grow more cane above it.

Sweet Berry Bush

Name	Default value	Allowed values	Description
age‌[JE only] growth‌[BE only]	0	0	Young plant
		1	No berries
		2	Some berries, using the bush will give 1-2 sweet berries and set the age back to 1.
		3	Full berries, using the bush will give 2-3 sweet berries and set the age back to 1.

Tall Grass and Large Fern

Java Edition:
Tall grass and large fern

Name	Default value	Allowed values	Description
half	lower	lower upper	The half of the plant contained in this block.

Bedrock Edition:
Grass and fern

Name	Default value	Allowed values	Description
tall_grass_type	default	default tall fern snow	The variant of this block, snow is snowlogged grass. (default looks the same as tall)

Tall grass and large fern

Name	Default value	Allowed values	Description
double_flower_type	sunflower	fern grass paeonia rose sunflower syringa	The flower type.
upper_block_bit	false	false true	If the upper half of the plant contained in this block.

Tall Seagrass

Java Edition:
Tall

Name	Default value	Allowed values	Description
half	lower	lower upper	The half of the plant contained in this block.

TNT

Java Edition:

Name	Default value	Allowed values	Description
unstable	false	false	Hitting the TNT block breaks it, dropping it as an item that can be picked up.
		true	Hitting the TNT block causes it to ignite and then explode.

Bedrock Edition:

Name	Default value	Allowed values	Description
allow_underwater_bit	false	false	This is normal TNT.
		true	This is Underwater TNT.
explode_bit	false	false	Hitting the TNT block breaks it, dropping it as an item that can be picked up.
		true	Hitting the TNT block causes it to ignite and then explode.

Trapdoors

iron_trapdoor

oak_trapdoor

spruce_trapdoor

birch_trapdoor

jungle_trapdoor

acacia_trapdoor

dark_oak_trapdoor

Java Edition:

Name	Default value	Allowed values	Description
facing	north	east north south west	The direction the trapdoor swings open. The opposite from the side its hinge is attached to.
half	bottom	bottom top	Whether the trapdoor occupies the top or bottom part of a block.
open	false	false true	True if the trapdoor is currently open (may differ from powered).
powered	false	false true	True if the trapdoor is currently powered (may differ from open).
waterlogged	false	false true	Whether or not there's water in the same place as this trapdoor.

Tripwire

Java Edition:

Name	Default value	Allowed values	Description
attached	false	false true	True if the tripwire is connected to a valid tripwire circuit.
disarmed	false	false true	True if the tripwire is disarmed, that is, broken using shears.
east	false	false true	True if the tripwire connects to other tripwire or tripwire hooks to the east.
north	false	false true	True if the tripwire connects to other tripwire or tripwire hooks to the north.
powered	false	false true	True if the tripwire is active.
south	false	false true	True if the tripwire connects to other tripwire or tripwire hooks to the south.
west	false	false true	True if the tripwire connects to other tripwire or tripwire hooks to the west.

Tripwire Hook

Java Edition:

Name	Default value	Allowed values	Description
attached	false	false true	True if the tripwire hook is connected to a valid tripwire circuit.
facing	north	east north south west	The direction in which the tripwire hook juts out from the block it is attached to. For example, a tripwire hook facing north will be attached to a block to its south.
powered	false	false true	True if the tripwire hook is active.

Turtle Egg

Java Edition:

Name	Default value	Allowed values	Description
eggs	1	1 2 3 4	Number of eggs.
hatch	0	0 1 2	Determines how close an egg is to hatching; starts at 0 and is randomly incremented.

Vines

Java Edition:

Name	Default value	Allowed values	Description
east	false	false true	When true, a vine texture is displayed on the east.
north	false	false true	When true, a vine texture is displayed on the north.
south	false	false true	When true, a vine texture is displayed on the south.
up	false	false true	When true, a vine texture is displayed on the top.
west	false	false true	When true, a vine texture is displayed on the west.

Wall Torch

Java Edition:
Wall

Name	Default value	Allowed values	Description
facing	north	east north south west	The direction the top of the torch is facing.

Bedrock Edition:

Name	Default value	Allowed values	Description
torch_facing_direction	top	east north south top unknown west	The direction the top of the torch is facing.

Walls

cobblestone_wall

mossy_cobblestone_wall

Java Edition:

Name	Default value	Allowed values	Description
east	false	false true	When true, the wall extends from the center post to the east.
north	false	false true	When true, the wall extends from the center post to the north.
south	false	false true	When true, the wall extends from the center post to the south.
up	true	false true	When true, the wall has a center post.
waterlogged	false	false true	Whether or not there's water in the same place as this wall.
west	false	false true	When true, the wall extends from the center post to the west.

Bedrock Edition:

Name	Default value	Allowed values	Description
wall_block_type	cobblestone	andesite brick cobblestone diorite end_brick granite mossy_cobblestone mossy_stone_brick nether_brick prismarine red_nether_brick red_sandstone sandstone stone_brick	The type of wall; for example, stone_brick denotes a stone brick wall.

Water

Java Edition:

Name	Default value	Allowed values	Description
level	0	0	Water source block.
		1 2 3 4 5 6 7	The distance from a water source or falling water block.
		8 9 10 11 12 13 14 15	Falling water. This level is equal to the falling water above, and if it's non-falling, equal to 8 plus the level of the non-falling water above it.

Bedrock Edition:
Water and flowing water

Name	Default value	Allowed values	Description
liquid_depth	0	0	Water source block.
		1 2 3 4 5 6 7	The distance from a water source or falling water block.
		8 9 10 11 12 13 14 15	Falling water. This level is equal to the falling water above, and if it's non-falling, equal to 8 plus the level of the non-falling water above it.

Wheat

Name	Default value	Allowed values	Description
age‌[JE only] growth‌[BE only]	0	0
		1
		2
		3
		4
		5
		6
		7	Fully-grown.

Wood

oak_wood

spruce_wood

birch_wood

jungle_wood

acacia_wood

dark_oak_wood

stripped_oak_wood

stripped_spruce_wood

stripped_birch_wood

stripped_jungle_wood

stripped_acacia_wood

stripped_dark_oak_wood

Java Edition:

Name	Default value	Allowed values	Description
axis	y	x	The wood is oriented east–west.
		y	The wood is oriented vertically.
		z	The wood is oriented north–south.

History

Java Edition
1.8		14w11a			Added block states. Only used in the game engine, not saved in world files or used in commands yet.
		14w26a			Switched to mostly using block states in the code.
1.11		16w32a			Enabled the use of block states in commands.
1.13		17w47a			Many block states got added, changed and removed due to the Flattening.
					Added the debug stick, which is an item used to edit the block states of blocks.