{{distinguish|Badlands}}
{{infobox structure
| image1size = 300px
| canspawn = Yes
| biome =
* {{EnvLink|Overworld}}
}}
'''Canyons'''<ref>{{snap|21w06a|February 10, 2021}}</ref> (formerly and commonly known as '''ravines''') are deep and long cracks breaching the underground layers of the [[Overworld]]. Occasionally, they may breach the surface, potentially exposing caves that would not normally be visible otherwise.

== Structure ==
Canyons are around 85 to 127 blocks in length and typically less than 15 blocks wide. [[Water]]-filled canyons can also be found in any [[ocean]] biome. Canyons are up to 62 blocks in depth and can start at levels 10 to 72. Canyons in [[amplified]] worlds and {{in|be}} may go all the way down to the [[bedrock]] layer, causing canyons spawning in mountainous [[biome]]s to appear deeper. A canyon extending down to bedrock causes [[lava]] sources to generate at the bottom. [[Obsidian]] often forms at the bottom as water [[spring]]s flow down into the lava.

Canyons may have small ledges along the top. Deep canyons sometimes spawn [[slime]]s or expose a [[diamond ore]] vein. Canyons may also be floored by the lava lakes at level -55 or even deeper.

Canyons can connect to caves, [[amethyst geode]]s, [[monster room]]s, [[mineshaft]]s, [[stronghold]]s or any other generated [[structure]]s. Due to the large surface area of their walls, canyons often have water and lava flowing down them from springs in the walls, aquifers or openings to a lake or an ocean biome. A canyon that intersects a [[river]], a [[frozen river]] or a [[swamp]] is filled with stone under the body of water.

=== Lava lakes ===
[[File:Lava Ravine.png|thumb|A lava lake inside of a canyon.]]
Similarly to how lakes replace all [[air]] blocks below a certain altitude on the surface, when deep enough in a canyon, all blocks that would generate as air instead generate as lava lakes.

== Generation ==
{{main|World generation#Carvers}}

== Data values ==
=== ID ===
{{el|je}}:
{{ID table
|firstcolumnname=Configured carver
|displayname=[No displayed name]
|spritename=canyon
|spritetype=env
|nameid=canyon
|foot=1}}

{{el|be}}:
{{ID table
|firstcolumnname=[[Feature]]
|displayname=[No displayed name]
|spritename=canyon
|spritetype=env
|nameid=[No ID]
|foot=1}}

== History ==
{{HistoryTable
|{{HistoryLine|java beta}}
|{{HistoryLine||May 17, 2011|link=Java Edition Beta 1.2 02 (20110517)|Ravines are included as unused content in a developer fork of [[Beta 1.2_02]], nearly 4 months before being added.}}
|{{HistoryLine||1.8|dev=Pre-release|Added ravines.}}
|{{HistoryLine|java}}
|{{HistoryLine||1.13|dev=18w06a|Ravines now generate in [[the Nether]].}}
|{{HistoryLine|||dev=18w08a|Ravines can now generate underwater in [[ocean]]s.}}
|{{HistoryLine||1.14|dev=18w43a|Ravines are now known as Canyons.}}
|{{HistoryLine||1.17|dev=21w06a|Canyons can no longer generate underwater in oceans.}}
|{{HistoryLine|||dev=21w15a|Canyons can once again generate underwater in oceans.}}
|{{HistoryLine||1.18|dev=Experimental Snapshot 1|Canyons can no longer generate underwater in oceans.}}
|{{HistoryLine|||dev=experimental snapshot 6|Canyons can once again generate underwater in oceans.}}
|{{HistoryLine|bedrock}}
|{{HistoryLine||1.2.0|dev=beta 1.2.0.2|Added ravines.}}
|{{HistoryLine||1.4.0|dev=beta 1.2.14.2|Ravines can now generate underwater.}}
|{{HistoryLine|bedrock upcoming}}
|{{HistoryLine||1.21.60|dev=Preview 1.21.60.24|Now generate more often|Can once again generate on the [[ocean]] floor|Now completely carve through [[Copper Ore]] veins|Now properly interact with [[aquifer]]s, filling with [[water]] instead of generating as disconnected segments}}

|{{HistoryLine|console}}
|{{HistoryLine||xbox=TU5|xbone=CU1|ps3=1.00|psvita=1.00|ps4=1.00|wiiu=Patch 1|switch=1.0.1|Added ravines.}}
|{{HistoryLine||xbox=TU69|xbone=none|ps3=1.76|psvita=1.76|ps4=1.76|wiiu=Patch 38|switch=none|Ravines can now generate underwater in [[ocean]]s.}}
}}
<gallery>
1.2 02 secret canyon.png|Canyons were included unused in [[Java Edition Beta 1.2_02 (20110517)|a developer fork of 1.2_02]].
Notch canyon.png|The first image of a ravine.
Ruins1.png|An image from Notch of a ravine cutting through a stronghold.
</gallery>

== Issues ==
{{issue list|Canyon|Ravine}}

== Trivia ==
* {{IN|bedrock}} the [[Seed (world generation)|seed]] 1669320484 generates a huge canyon extending endlessly from southwest to northeast at [[coordinate]] X=−1269, Z=0, shaped by countless identical connected north-south canyons. There are other lines of canyons parallel to this one, but few of them are visible aboveground or have the canyons connected. This seed also generates parallel lines of endless [[dungeon]]s underground. As of 1.18, nearly all endless canyons are underground.
* It is relatively common to find multiple intersecting canyons, often running perpendicular to the parent canyon, on different Y levels. Before the introduction of large [[noise caves]] in 1.18, this phenomenon led to some of the largest possible caves in the game.
* An early version of canyons exist in an [[Java Edition Beta 1.2 02 (20110517)|unreleased build of Beta 1.2_02]], generating above and underground, and being noticeably shorter in height.
<gallery>
Endlesscanyon wideangle.png|Wide-angle view of endless canyon in [[Bedrock Edition]] seed 1669320484.
Endlesscanyon3.png|View toward horizon along endless canyon.
Endlesscanyonvillage.png|Village generated on the rim of the endless canyon.
</gallery>

== Gallery ==
<gallery>
Two intersecting canyons.png|Two canyons joined together underground.
Canyon split by river.png|Two canyons open to the sky that generated next to each other, with a [[river]] biome between them.
Underwater canyon.png|An underwater canyon.
Mineshaft in a surface canyon.png|A canyon that exposed a mineshaft.
Deepcliff.png|A deep cliff reaching bedrock levels.
Double canyon.png|A canyon generated under another canyon.
Thin canyon.png|A small canyon viewed from the sky.
The Pit.png|A canyon viewed from inside.
Canyon obstructed by ocean.png|A canyon that has been cut through by an ocean.
Partially exposed canyon.png|A hole in the ground through which a canyon is visible.
LapisOreSunlight.png|Iron and lapis ores exposed to sunlight in deep canyon.
River flowing into canyon.jpg|Water flowing into the canyon from nearby river.
Water truncated by canyon.jpg|Canyon generation may not always update nearby water.
Tree in a canyon.png|A tree that generated in a canyon, next to the lava and mineshaft.
Endlesscanyon water glitch.png|Water generated in midair over a large connected canyon.
Multiple structures in a canyon.png|A [[jungle pyramid]], [[stronghold]], and [[mineshaft]] generated together in one canyon.
Triplecanyonwithmineshaft.png|A triple canyon with a mineshaft at the bottom.
Deep ores.png|Naturally generated [[diamond ore]], [[redstone ore]], and [[lapis lazuli ore]] found in a canyon. Check the image for seed and coordinates.
Merged underwater.png|Two underwater canyons merged together.
120 block deep canyon.png|A 120 block deep canyon in ''Bedrock Edition''.
Slimcanyon.png|Relatively slim and shallow canyon in plains biome.
Slimanddeep.png|Slim, but rather deep canyon generated in plains biome.
Mineshaft in an underground canyon.png|Double canyon with many mineshaft bridges in it.
Cold ocean canyon.png|A canyon that generated underwater.
Canyon intersecting a stronghold.png|Canyon with multiple ores, water and lava falls, and stronghold bridge over it.
Badlands mineshaft in canyon.png|Badlands mineshaft bridge generated over a canyon.
Ruined portal on top of a canyon.png|A ruined portal generated on top of a canyon.
Better Together canyon 1.jpg|A canyon in Bedrock Edition.
Better Together canyon 2.jpg|A canyon in Bedrock Edition.
Better Together canyon 3.jpg|A canyon in Bedrock Edition.
Nether canyon.jpg|A canyon in the Nether.
</gallery>

== References ==
<references />

== Navigation ==
{{Navbox terrain features}}

[[es:Cueva#Cañón]]
[[ja:峡谷]]
[[ko:협곡]]
[[pt:Ravina]]
[[ru:Каньон]]
