Block states

Block states (also known as block properties) are extra pieces of data that further define a block, such as how it appears or behaves.

In Bedrock Edition, there are also aux values (also known as Metadata) to define a block. Aux values are in the format of binary flags, which basically match the block states one-to-one, and they are accessible in decimal number in commands. However, aux values are intended to be deprecated, and newly added blocks or block states no longer support aux values.

In Java Edition, there are also fluid states, that further define a fluid as to how it behaves.

List of block states

age

Tracks the age of plants to handle growth and of fire to handle spread.

State value	Blocks
Integer (0 to 1)	Bamboo Torchflower Crop
Integer (0 to 2)	Cocoa
Integer (0 to 3)	Nether Wart Beetroots Frosted Ice Sweet Berry Bush
Integer (0 to 4)	Pitcher Crop
Integer (0 to 5)	Chorus Flower
Integer (0 to 7)	Wheat Crops Pumpkin Stem Melon Stem Carrots Potatoes
Integer (0 to 15)	Fire Cactus Sugar Cane
Integer (0 to 25)	Cave Vines Kelp

attached

Whether the tripwire hook is connected to a valid tripwire circuit or not. For hanging signs, whether the sign is hanging from a single point or not.

State value	Blocks
Boolean (false or true)	Tripwire Hook Tripwire Hanging Sign (any non-wall variant)

attachment

How this block is attached to the block it is on.

State value	Blocks
ceiling double_wall floor single_wall	Bell

axis

What axis the block is oriented to.

State value	Blocks
x y z	Deepslate (including infested variant) Froglight (any) Log (including all variants, wood, bamboo, and stripped versions of bamboo, logs, and wood) Stem (including all variants, hyphae, and stripped versions of both stems and hyphae) Basalt (including polished basalt) Bone Block Muddy Mangrove Roots Chain Hay Bale Purpur Pillar Quartz Pillar
x z	Nether Portal

berries

Whether this block contains any berries.

State value	Blocks
Boolean (false or true)	Cave Vines Cave Vines Plant

bites

The number of bites taken from the cake.

State value	Blocks
Integer (0 to 6)	Cake

bloom

Whether a sculk catalyst is currently blooming.

State value	Blocks
Boolean (false or true)	Sculk Catalyst

bottom

Whether this scaffolding is floating (shows the bottom).

State value	Blocks
Boolean (false or true)	Scaffolding

can_summon

Whether this shrieker can summon a warden if triggered.

State value	Blocks
Boolean (false or true)	Sculk Shrieker

candles

How many candles are contained within this block.

State value	Blocks
Integer (1 to 4)	Candle (any)

charges

Tracks the remaining uses of respawn anchors.

State value	Blocks
Integer (0 to 4)	Respawn Anchor

conditional

Whether or not the command block is conditional.

State value	Blocks
Boolean (false or true)	Command Block (any variant)

cracked

Whether or not a decorated pot produces shattering sound when broken.

State value	Blocks
Boolean (false or true)	Decorated Pot

crafting

Whether a crafter is currently crafting.

State value	Blocks
Boolean (false or true)	Crafter

delay

The amount of time between receiving a signal and responding.

State value	Blocks
Integer (1 to 4)	Redstone Repeater

disarmed

Whether the tripwire is broken using shears or not.

State value	Blocks
Boolean (false or true)	Tripwire

distance

The distance from a base block.

State value	Blocks
Integer (0 to 7)	Scaffolding
Integer (1 to 7)	Leaves (any)

down

Determines whether something is below the block.

State value	Blocks
Boolean (false or true)	Brown Mushroom Block Chorus Plant Glow Lichen Mushroom Stem Red Mushroom Block Sculk Vein

drag

Determines whether the bubble column is a whirlpool or upwards.

State value	Blocks
Boolean (false or true)	Bubble Column

dusted

The dusting progress of a suspicious block.

State value	Blocks
Integer (0 to 3)	Suspicious Gravel Suspicious Sand

east

Determines whether something is on the east side of the block.

State value	Blocks
Boolean (false or true)	Fence (any, including nether brick) Glass Pane (including all stained colors) Brown Mushroom Block Chorus Plant Fire Glow Lichen Iron Bars Mushroom Stem Red Mushroom Block Sculk Vein Tripwire Vines
none side up	Redstone Dust
low none tall	Wall (any)

eggs

The amount of eggs in this block.

State value	Blocks
Integer (1 to 4)	Turtle Egg

enabled

Whether or not the hopper can collect and transfer items.

State value	Blocks
Boolean (false or true)	Hopper

extended

Whether or not the piston is extended.

State value	Blocks
Boolean (false or true)	Sticky Piston Piston

eye

Whether the frame contains an eye of ender.

State value	Blocks
Boolean (false or true)	End Portal Frame

face

What side of a block the attached block is on.

State value	Blocks
ceiling floor wall	Button (any) Grindstone Lever

facing

For most blocks, what direction the block faces.

For wall-attached bells as well as cocoa, the opposite is true.

State value	Blocks
down east north south west up	Amethyst Cluster (any stage) Command Block (any variant) Shulker Box (any color) Barrel Dispenser Dropper End Rod Lightning Rod Moving Piston Observer Piston Piston Head Sticky Piston
east north south west	Anvil (any durability) Banner (any wall variant) Bed (any) Coral Wall Fan (any variant, including dead) Button (any) Door (any) Fence Gate (any) Glazed Terracotta (any color) Mob head (any wall variant) Signs (any wall variant) Hanging Signs (any wall variant) Stairs (any) Trapdoor (any, including iron) Attached Melon Stem Attached Pumpkin Stem Bell Beehive Bee Nest Big Dripleaf Big Dripleaf Stem Blast Furnace Campfire Carved Pumpkin Chest Chiseled Bookshelf Cocoa Decorated Pot End Portal Frame Ender Chest Furnace Grindstone Jack o'Lantern Ladder Lectern Lever Loom Pink Petals Redstone Comparator Redstone Repeater Redstone Wall Torch Small Dripleaf Smoker Soul Campfire Soul Wall Torch Stonecutter Trapped Chest Tripwire Hook Vault Wall Torch
down east north south west	Hopper

falling

Whether a fluid is falling.

State value	Blocks
Boolean (false or true)	Lava Water

flower_amount

The amount of flowers in a group of pink petals.

State value	Blocks
Integer (1 to 4)	Pink Petals

half

For tall plants and doors, which half of the door or plant occupies the block space. For trapdoors and stairs, what part of the block space they are in.

State value	Blocks
lower upper	Door (any) Pitcher Plant (including crop variant) Large Fern Lilac Peony Rose Bush Tall Seagrass Tall Grass Small Dripleaf Sunflower
bottom top	Stairs (any) Trapdoor (any, including iron)

hanging

Whether or not the lantern hangs on the ceiling.

State value	Blocks
Boolean (false or true)	Lantern Soul Lantern

has_book

Whether or not this lectern holds a book.

State value	Blocks
Boolean (false or true)	Lectern

has_bottle_0

Whether or not a bottle is in slot 1 of the brewing stand.

State value	Blocks
Boolean (false or true)	Brewing Stand

has_bottle_1

Whether or not a bottle is in slot 2 of the brewing stand.

State value	Blocks
Boolean (false or true)	Brewing Stand

has_bottle_2

Whether or not a bottle is in slot 3 of the brewing stand.

State value	Blocks
Boolean (false or true)	Brewing Stand

has_record

True when the jukebox contains a music disc.

State value	Blocks
Boolean (false or true)	Jukebox

hatch

Determines how close an egg is to hatching; starts at 0 and is randomly incremented.

State value	Blocks
Integer (0 to 2)	Sniffer Egg Turtle Egg

hinge

Identifies the side the hinge is on (when facing the same direction as the door's inside).

State value	Blocks
left right	Door (any)

honey_level

The level of honey inside the beehive and bee nest.

State value	Blocks
Integer (0 to 5)	Beehive Bee Nest

in_wall

If true, the gate is lowered by three pixels, to accommodate attaching more cleanly with walls.

State value	Blocks
Boolean (false or true)	Fence Gate (any)

instrument

The instrument sound the note block makes when it gets powered or used.

State value	Blocks
banjo basedrum bass bell bit chime cow_bell didgeridoo flute guitar harp hat iron_xylophone snare xylophone	Note Block

inverted

Whether the daylight detector detects light (false) or darkness (true).

State value	Blocks
Boolean (false or true)	Daylight Detector

layers

How many layers of snow are on top of each other.

State value	Blocks
Integer (1 to 8)	Snow

leaves

How big the leaves are on this bamboo.

State value	Blocks
large none small	Bamboo

level

For cauldrons, composters, and fluids, describes how full the block is. For lights, describes the light level produced.

State value	Blocks
Integer (0 to 3)	Cauldron (water and powder snow)
Integer (0 to 8)	Composter
Integer (0 to 15)	Water Lava Light

lit

Whether the block is turned on or off.

State value	Blocks
Boolean (false or true)	Candle (any) Candle Cake (any) Copper Bulb (any) Blast Furnace Campfire Deepslate Redstone Ore Furnace Redstone Ore Redstone Torch Redstone Wall Torch Redstone Lamp Smoker Soul Campfire

locked

Whether the repeater can change it is powered state (false) or not (true).

State value	Blocks
Boolean (false or true)	Redstone Repeater

mode

The mode the comparator or structure block is in.

State value	Blocks
compare subtract	Redstone Comparator
corner data load save	Structure Block

moisture

How wet the farmland is.

State value	Blocks
Integer (0 to 7)	Farmland

north

Determines whether something is on the north side of the block.

State value	Blocks
Boolean (false or true)	Fence (any, including nether brick) Glass Pane (including all stained colors) Brown Mushroom Block Chorus Plant Glow Lichen Fire Iron Bars Mushroom Stem Red Mushroom Block Sculk Vein Tripwire Vines
up side none	Redstone Dust
low none tall	Wall (any)

note

The note the note block plays when it gets powered.

State value	Blocks
Integer (0 to 24)	Note Block

occupied

If there's already a player in this bed.

State value	Blocks
Boolean (false or true)	Bed (any)

ominous

Whether a trial spawner or vault is ominous.

State value	Blocks
Boolean (false or true)	Trial Spawner Vault

open

Whether the door is open or closed.

State value	Blocks
Boolean (false or true)	Door (any) Fence Gate (any) Trapdoor (any, including iron) Barrel

orientation

Direction the arrows point, followed by the position of the line face.

State value	Blocks
down_east down_north down_south down_west east_up north_up south_up up_east up_north up_south up_west west_up	Crafter Jigsaw Block

part

Whether this is the foot or head end of the bed.

State value	Blocks
foot head	Bed (any)

persistent

Whether leaves decay (false) or not (true)

State value	Blocks
Boolean (false or true)	Leaves (any)

pickles

The amount of pickles in this block.

State value	Blocks
Integer (1 to 4)	Sea Pickle

power

The power level of Redstone emission.

State value	Blocks
Integer (0 to 15)	Calibrated Sculk Sensor Daylight Detector Heavy Weighted Pressure Plate Light Weighted Pressure Plate Redstone Dust Sculk Sensor Target

powered

Whether the block is powered.

State value	Blocks
Boolean (false or true)	Button (any) Copper Bulb (any) Door (any) Fence Gate (any) Mob Head (any) Pressure Plate (any non-weighted) Trapdoor (any, including iron) Activator Rail Bell Calibrated Sculk Sensor Detector Rail Lectern Lever Lightning Rod Note Block Observer Powered Rail Redstone Comparator Redstone Repeater Sculk Sensor Tripwire Tripwire Hook

rotation

The rotation of standing heads, signs and banners.

State value	Blocks
Integer (0 to 15)	Banner (any non-wall variant) Hanging Signs (any non-wall variant) Mob head (any non-wall variant) Signs (any non-wall variant)

sculk_sensor_phase

Describes this sculk sensor's phase (whether it's active).

State value	Blocks
active cooldown inactive	Calibrated Sculk Sensor Sculk Sensor

shape

The way this block connects to its neighbors.

State value	Blocks
ascending_east ascending_north ascending_south ascending_west east_west north_south	Powered Rail Detector Rail Activator Rail
inner_left inner_right outer_left outer_right straight	Stairs (any)
ascending_east ascending_north ascending_south ascending_west east_west north_south north_east north_west south_east south_west	Rail

short

Whether this piston head's arm is 4/16th of a block shorter.

State value	Blocks
Boolean (false or true)	Piston Head

shrieking

Whether this sculk shrieker is shrieking.

State value	Blocks
Boolean (false or true)	Sculk Shrieker

signal_fire

Whether this campfire has higher smoke or not.

State value	Blocks
Boolean (false or true)	Campfire Soul Campfire

slot_0_occupied

Whether slot 0 is occupied by a book.

State value	Blocks
Boolean (false or true)	Chiseled Bookshelf

slot_1_occupied

Whether slot 1 is occupied by a book.

State value	Blocks
Boolean (false or true)	Chiseled Bookshelf

slot_2_occupied

Whether slot 2 is occupied by a book.

State value	Blocks
Boolean (false or true)	Chiseled Bookshelf

slot_3_occupied

Whether slot 3 is occupied by a book.

State value	Blocks
Boolean (false or true)	Chiseled Bookshelf

slot_4_occupied

Whether slot 4 is occupied by a book.

State value	Blocks
Boolean (false or true)	Chiseled Bookshelf

slot_5_occupied

Whether slot 5 is occupied by a book.

State value	Blocks
Boolean (false or true)	Chiseled Bookshelf

snowy

Whether this block uses the snowy side texture.

State value	Blocks
Boolean (false or true)	Grass Block Podzol Mycelium

south

Determines whether something is on the south side of the block.

State value	Blocks
Boolean (false or true)	Fence (any, including nether brick) Glass Pane (including all stained colors) Brown Mushroom Block Chorus Plant Fire Glow Lichen Iron Bars Mushroom Stem Red Mushroom Block Sculk Vein Tripwire Vines
none side up	Redstone Dust
low none tall	Wall (any)

stage

Whether this sapling is ready to grow.

State value	Blocks
Integer (0 to 1)	Sapling (any) Bamboo

thickness

The thickness of pointed dripstone.

State value	Blocks
base frustum middle tip tip_merge	Pointed Dripstone

tilt

The tilt stage of a big dripleaf.

State value	Blocks
full none partial unstable	Big Dripleaf

trial_spawner_state

The current state of a trial spawner.

State value	Blocks
inactive waiting_for_players active waiting_for_reward_ejection ejecting_reward cooldown	Trial Spawner

triggered

Whether this block has been activated.

State value	Blocks
Boolean (false or true)	Crafter Dispenser Dropper

type

Determines the variant of this block.

State value	Blocks
normal sticky	Piston Head Moving Piston
left right single	Chest Trapped Chest
bottom double top	Slab (any)

unstable

Whether the TNT explodes when punched or not.

State value	Blocks
Boolean (false or true)	TNT

up

Determines whether something is above the block.

State value	Blocks
Boolean (false or true)	Wall (any) Brown Mushroom Block Chorus Plant Fire Glow Lichen Mushroom Stem Red Mushroom Block Sculk Vein Vines

vault_state

The current state of a vault.

State value	Blocks
inactive active unlocking ejecting	Vault

vertical_direction

The vertical directon of pointed dripstone.

State value	Blocks
down up	Pointed Dripstone

waterlogged

Whether the block has water in it.

State value

Blocks

Boolean (false or true)

Amethyst Cluster (any stage) Candle (any) Copper Grate (any) Coral (all non-block variants, including dead variants) Fence (any, including nether brick) Glass Pane (including all stained colors) Hanging Signs (all variants, including wall signs) Leaves (any) Signs (all variants, including wall signs) Slab (any) Stairs (any) Trapdoor (any, including iron) Wall (any) Activator Rail Barrier Big Dripleaf Big Dripleaf Stem Campfire Calibrated Sculk Sensor Chain Chest Conduit Decorated Pot Detector Rail Ender Chest Glow Lichen Hanging Roots Heavy Core Iron Bars Ladder Lantern Light Lightning Rod Mangrove Roots Pointed Dripstone Powered Rail Rail Scaffolding Sculk Sensor Sculk Shrieker Sculk Vein Small Dripleaf Sea Pickle Soul Campfire Soul Lantern Trapped Chest

west

Determines whether something is on the west side of the block.

State value	Blocks
Boolean (false or true)	Fence (any, including nether brick) Glass Pane (including all stained colors) Brown Mushroom Block Chorus Plant Fire Glow Lichen Iron Bars Mushroom Stem Red Mushroom Block Sculk Vein Tripwire Vines
none side up	Redstone Dust
low none tall	Wall (any)

List of fluid states

Water

Java Edition:
Water

Name	Default value	Allowed values	[hide]Description
falling	false	true false	Always false.

Flowing water

Name	Default value	Allowed values	[hide]Description
falling	false	true false	True for falling water, false for water with a block below.
level	1	1 2 3 4 5 6 7 8	Height of the water, 8 when the water is falling.

Lava

Java Edition:
Lava

Name	Default value	Allowed values	[hide]Description
falling	false	true false	Always false.

Flowing lava

Name	Default value	Allowed values	[hide]Description
falling	false	false true	True for falling lava, false for lava with a block below.
level	1	1 2 3 4 5 6 7 8	Height of the lava, 8 when the lava is falling.

Joke block states

Big Brain

Name	Default value	Allowed values	[hide]Description
facing	north	east north south west	The direction the big brain is facing

Cheese

Name	Default value	Allowed values	[hide]Description
slices	255	1—255	Interpreted as an array of binary numbers that define whether or not each 1/8th corner (slice) of cheese is present. The binary digits for this value are, in order of most significant to least significant, bottom north-west, bottom north-east, bottom south-west, bottom south-east, top north-west, top north-east, top south-west, and top south-east. For example, 255 is all slices present, 204 is all northern slices eaten and all southern slices present.

Floatater

Name	Default value	Allowed values	[hide]Description
facing	north	east north south west	The direction this floatater is facing.
triggered	false	false true	True if this block is activated.

Frying Table

Name	Default value	Allowed values	[hide]Description
facing	north	east north south west	The direction the frying table is facing. The opposite from the direction the player faces while placing the frying table.
lit	true	false true	Whether the frying table is lit.
signal_fire	false	false true	Whether the frying table has a hay bale below it.
waterlogged	false	false true	Whether or not there's water in the same place as this frying table.

Funky Portal

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

How did we get here?

Name	Default value	Allowed values	[hide]Description
item	0	0 1 2 ... 1104	The number display the item ID on it. See How did we get here? (block)/Display.
waterlogged	false	false true	Whether or not there's water in the same place as this how did we get here? block.

Other Portal

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

Poisonous Potato Cutter

Name	Default value	Allowed values	[hide]Description
facing	north	east north south west	The direction this poisonous potato cutter is facing.

Potato Battery

Name	Default value	Allowed values	[hide]Description
inverted	false	false true	If true, the potato battery is active.

Potato Refinery

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

Powerful Potato

Name	Default value	Allowed values	[hide]Description
age	0	0 1 2 3	The powerful potato can grow strong roots when its age is not 3.

Removed block states states

Shrub

Java Edition:

Name	Default value	Allowed values	[hide]Description
type	?	dead_bush	Shrub
		fern	Fern
		tall_grass	Grass

Bedrock Edition:

Name	Metadata Bits	Default value	Allowed values	Values for Metadata Bits	[hide]Description
tall_grass_type	0x1 0x2	default	default	0	Fern (Unused variant which looks identical to grass)
			tall	1	Grass
			fern	2	Fern
			snow	3	Fern (Unused variant which looks identical to fern)

History

[hide]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.
							Fluids are now semi-independent from blocks, so they now have their own fluid states.
1.20.2			23w35a				Added powered block state for heads.