Block states

Block states (also known as block properties)^{[note 1]} 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

This article needs to be updated.

Please update this page to reflect recent updates or newly available information.
Reason: not updated for more recent versions; only covers Java Edition

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.^[1]

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` `creeper` `custom_head` `didgeridoo` `dragon` `flute` `guitar` `harp` `hat` `iron_xylophone` `piglin` `pling` `skeleton` `snare` `xylophone` `zombie`	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 Detector Rail Lectern Lever Lightning Rod Note Block Observer Powered Rail Redstone Comparator Redstone Repeater 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

falling

Whether a fluid is falling.

State value	Fluids
Boolean (`false` or `true`)	Flowing Lava Flowing Water Lava (always false) Water (always false)

level

Determines the height of the fluid, 8 when the fluid is falling.

State value	Fluids
Integer (`1` to `8`)	Flowing Lava Flowing Water

History

This section is missing information about: the history in Bedrock Edition.

Please expand the section to include this information. Further details may exist on the talk page.

Java Edition
1.8	14w11a	Added block states. Only used in the game engine, not saved in world files or used in commands yet.
1.8	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.

Notes

↑ Sometimes they're different: A block state may refer to a state of the block type, also known as a block permutation in Bedrock Edition, e.g. a south facing pressed button. While a block property refers to a specific property used to define a block state, e.g. facing property of button block.

References

↑ MC-193943

Navigation

[1] Sometimes they're different: A block state may refer to a state of the block type, also known as a block permutation in Bedrock Edition, e.g. a south facing pressed button. While a block property refers to a specific property used to define a block state, e.g. facing property of button block.

[2] MC-193943

[note 1]

[1]