View source for Minecraft:Dye

{{redirect|Dyeing|dying|Death}}
{{Infobox item
| title = Dyes
| group = White
| 1-1 = White Dye.png
| invimage = White Dye
| group2 = Light Gray
| 2-1 = Light Gray Dye.png
| invimage2 = Light Gray Dye
| group3 = Gray
| 3-1 = Gray Dye.png
| invimage3 = Gray Dye
| group4 = Black
| 4-1 = Black Dye.png
| invimage4 = Black Dye
| group5 = Brown
| 5-1 = Brown Dye.png
| invimage5 = Brown Dye
| group6 = Red
| 6-1 = Red Dye.png
| invimage6 = Red Dye
| group7 = Orange
| 7-1 = Orange Dye.png
| invimage7 = Orange Dye
| group8 = Yellow
| 8-1 = Yellow Dye.png
| invimage8 = Yellow Dye
| group9 = Lime
| 9-1 = Lime Dye.png
| invimage9 = Lime Dye
| group10 = Green
| 10-1 = Green Dye.png
| invimage10 = Green Dye
| group11 = Cyan
| 11-1 = Cyan Dye.png
| invimage11 = Cyan Dye
| group12 = Light Blue
| 12-1 = Light Blue Dye.png
| invimage12 = Light Blue Dye
| group13 = Blue
| 13-1 = Blue Dye.png
| invimage13 = Blue Dye
| group14 = Purple
| 14-1 = Purple Dye.png
| invimage14 = Purple Dye
| group15 = Magenta
| 15-1 = Magenta Dye.png
| invimage15 = Magenta Dye
| group16 = Pink
| 16-1 = Pink Dye.png
| invimage16 = Pink Dye
| renewable = Yes
| stackable = Yes (64)
}}
[[File:In-game colored block-item chart v2.png|alt=Colored block/item chart|thumb|width=325x325|In-game colored block/item spectrum]]
'''Dyes''' are a set of sixteen items used to change the color of [[Minecraft:wool]], [[Minecraft:carpet]]s, [[Minecraft:terracotta]], [[Minecraft:concrete powder]], [[Minecraft:glass]], [[Minecraft:shulker box]]es, [[Minecraft:bed]]s, [[Minecraft:candle]]s, [[Minecraft:bundle]]s, [[Minecraft:harness]]es, the patterns on [[Minecraft:banner]]s, [[Minecraft:firework star]]s, certain mobs, and text on [[Minecraft:sign]]s and [[Minecraft:hanging sign]]s. {{IN|bedrock}}, they can be used to dye water in a [[Minecraft:cauldron]] (which is thereafter used to dye [[Minecraft:leather armor]]) and [[Minecraft:shulker]]s; {{in|java}}, leather armor can be dyed directly. {{IN|education}}, they can be used to dye [[Minecraft:balloon]]s and [[Minecraft:glow stick]]s.

{{IN|bedrock|education}}, [[Minecraft:bone meal]], [[Minecraft:ink sac]]s, [[Minecraft:lapis lazuli]], and [[Minecraft:cocoa bean]]s can generally substitute for [[Minecraft:white dye]], [[Minecraft:black dye]], [[Minecraft:blue dye]], and [[Minecraft:brown dye]], respectively, in crafting recipes and for use in dyeing items or mobs. However, they have other important uses that aren't related to color, and are therefore not considered true dyes. They are mentioned in this article only regarding their use as dyeing agents; see their individual articles for complete information about them.
[[File:Dye Recipes.png|thumb|400px|A guide for creating all the dyes]]

== Obtaining ==
[[File:Dye_creation_chart.png|thumb|400px|A chart showing which pairs of dyes can be used to craft other dyes]]
Most dyes can be crafted from [[Minecraft:flower]]s and a few other items; some dyes can be crafted by combining multiple dyes of different colors, and every dye is [[Minecraft:trading|sold]] by the [[Minecraft:wandering trader]]. Some dyes can be found in loot, and [[Minecraft:green dye]] is obtained by smelting [[Minecraft:cactus]].

{| class="wikitable" style="text-align:right;"
|+ Main articles
|-
| {{ItemLink|White Dye|link=White Dye#Obtaining}} || {{ItemLink|Light Gray Dye|link=Light Gray Dye#Obtaining}}
|-
| {{ItemLink|Gray Dye|link=Gray Dye#Obtaining}} || {{ItemLink|Black Dye|link=Black Dye#Obtaining}}
|-
| {{ItemLink|Brown Dye|link=Brown Dye#Obtaining}} || {{ItemLink|Red Dye|link=Red Dye#Obtaining}}
|-
| {{ItemLink|Orange Dye|link=Orange Dye#Obtaining}} || {{ItemLink|Yellow Dye|link=Yellow Dye#Obtaining}}
|-
| {{ItemLink|Lime Dye|link=Lime Dye#Obtaining}} || {{ItemLink|Green Dye|link=Green Dye#Obtaining}}
|-
| {{ItemLink|Cyan Dye|link=Cyan Dye#Obtaining}} || {{ItemLink|Light Blue Dye|link=Light Blue Dye#Obtaining}}
|-
| {{ItemLink|Blue Dye|link=Blue Dye#Obtaining}} || {{ItemLink|Purple Dye|link=Purple Dye#Obtaining}}
|-
| {{ItemLink|Magenta Dye|link=Magenta Dye#Obtaining}} || {{ItemLink|Pink Dye|link=Pink Dye#Obtaining}}
|}

=== Crafting dye ===
{{:Crafting/Dye}}

=== Smelting ===
{{smelting|head=1|Sea Pickle|Lime Dye|0,1}}
{{smelting|foot=1|Cactus|Green Dye|1|}}

=== Generated loot ===
{{LootChestItem|blue-dye,green-dye,orange-dye,light-blue-dye,yellow-dye,white-dye}}

=== Trading ===
[[File:Wandering Trader GUI.png|thumb|right|The trading UI of a wandering trader in ''Java Edition'', showing 3 orange dye being sold.]]
[[Minecraft:Wandering trader]]s may sell 3 of any dye for 1 [[Minecraft:emerald]].
{{Trade sources|White Dye|Light Gray Dye|Gray Dye|Black Dye|Brown Dye|Red Dye|Orange Dye|Yellow Dye|Lime Dye|Green Dye|Cyan Dye|Light Blue Dye|Blue Dye|Purple Dye|Magenta Dye|Pink Dye}}

=== Mob loot ===
{{IN|bedrock}}, [[Minecraft:wandering traders]] have a chance of 8.5% (increased by 1% per level of [[Minecraft:Looting]]) to drop 3 dyes when killed while showing the item as trade offer, if the player holds an [[Minecraft:emerald]].

== Usage ==
=== Crafting ===
Dye can be used to add dye to undyed items through [[Minecraft:crafting]], and to craft dyed items directly. {{IN|bedrock}}, [[Minecraft:bone meal]], [[Minecraft:ink sac]]s, [[Minecraft:lapis lazuli]], and [[Minecraft:cocoa beans]] can be substituted for the corresponding dye in any of the following usages unless otherwise specified. <!--- sections are ordered by craftable dyeable blocks, dyeable items, version exclusive sections, and non-crafting miscellaneous uses--->
==== Wool ====
A piece of [[Minecraft:wool]] in any color can be dyed by combining 1 wool with any dye in a crafting grid.
{{Crafting
|ignoreusage=1
|Any Wool
|Matching Dye
|Output=Matching Wool
}}

==== Carpets ====
A [[Minecraft:carpet]] of any color can be dyed by combining 1 carpet with any dye in a crafting grid.
{{Crafting
|ignoreusage=1
|Any Carpet
|Matching Dye
|Output=Matching Carpet
}}

==== Terracotta ====
[[Minecraft:Terracotta]] can be [[Minecraft:Stained Terracotta|stained]] by placing 8 blocks of terracotta around a dye in a 3×3 crafting table. Stained terracotta can not be restained to a different color.
{{Crafting
|ignoreusage=1
|A1=Terracotta
|B1=Terracotta
|C1=Terracotta
|A2=Terracotta
|B2=Matching Dye
|C2=Terracotta
|A3=Terracotta
|B3=Terracotta
|C3=Terracotta
|Output=Matching Stained Terracotta,8
}}

==== Concrete powder ====
Dyes can be used to craft [[Minecraft:concrete powder]], which can then be set into their respective [[Minecraft:concrete]] blocks. Concrete powder and concrete cannot be redyed.
{{Crafting
|ignoreusage=1
|Sand
|Gravel
|Sand
|Gravel
|Matching Dye
|Gravel
|Sand
|Gravel
|Sand
|Output=Matching Concrete Powder,8
}}

==== Stained glass ====
[[Minecraft:Glass]] can be [[Minecraft:Stained Glass|stained]] by placing 8 blocks of glass around a dye in a 3×3 crafting grid.
{{Crafting
|ignoreusage=1
|A1=Glass
|B1=Glass
|C1=Glass
|A2=Glass
|B2=Matching Dye
|C2=Glass
|A3=Glass
|B3=Glass
|C3=Glass
|Output=Matching Stained Glass,8
|head=1
|foot=1
}}

==== Stained glass panes ====
[[Minecraft:Glass pane|Glass panes]] can be [[Minecraft:Stained Glass Pane|stained]] by placing 8 glass panes around a dye in a 3×3 crafting grid.

{{Crafting
|ignoreusage=1
|A1= Glass Pane
|B1= Glass Pane
|C1= Glass Pane
|A2= Glass Pane
|B2= Matching Dye
|C2= Glass Pane
|A3= Glass Pane
|B3= Glass Pane
|C3= Glass Pane
|Output= Matching Stained Glass Pane,8
|head=1
|foot=1
}}

==== Shulker boxes ====
A [[Minecraft:shulker box]] can be dyed by combining it with any dye in a crafting grid. A dyed shulker can be re-dyed using the same crafting recipe. A dyed shulker box can only be [[Minecraft:Shulker Box#Undyeing|undyed]] using a [[Minecraft:cauldron]].<!-- this is put here because some people might wonder why dyeing it purple does not undye it -->
{{Crafting
|ignoreusage=1
|Any Shulker Box
|Matching Dye
|Output=Matching Shulker Box
}}

==== Beds ====
A [[Minecraft:bed]] of any color can be dyed, by combining it with any dye in a crafting grid.
{{Crafting
|ignoreusage=1
|Any Bed
|Matching Dye
|Output=Matching Bed
}}

==== Candles ====
An undyed [[Minecraft:candle]] can be dyed by combining it with any dye in a crafting grid.
{{Crafting
|ignoreusage=1
|Candle
|Matching Dye
|Output=Matching Dyed Candle
}}

==== Bundles ====
A [[Minecraft:bundle]] of any color can be dyed, by combining it with any dye in a crafting grid.
{{Crafting
|ignoreusage=1
|Any Bundle
|Matching Dye
|Output = Matching Dyed Bundle
}}

==== Harnesses ====
A [[Minecraft:harness]] of any color can be dyed, by combining it with any dye in a crafting grid.
{{Crafting
|ignoreusage=1
|Any Harness
|Matching Dye
|Output = Matching Harness
|foot = 1
}}

==== Firework stars ====
A [[Minecraft:firework star]] can have a single color or a combination of up to eight colors when crafted with dyes. Adding one or more dyes to a crafted firework star adds a "fade to color" effect to it, overwriting any existing fade colors.
{{Crafting
|head=1
|ignoreusage=1
|ingredients=[[Minecraft:Gunpowder]] +<br>Any Dye (1–8) +<br>Extra ingredient (optional)
|Gunpowder
|Matching Dye
|Diamond;Glowstone Dust;Gold Nugget;Feather;Fire Charge;
|Output=Matching Firework Star
}}
{{Crafting
|ignoreusage=1
|Matching Firework Star
|Any Dye
|Output=Matching Firework Star
|foot=1
}}

==== Balloons ====
{{education feature|section=1}}
Dye can be used to craft [[Minecraft:balloon]]s.
{{Crafting
|ignoreusage=1
|A1= Latex
|B1= Matching Dye
|C1= Latex
|A2= Latex
|B2= Helium
|C2= Latex
|A3= Latex
|B3= Lead
|C3= Latex
|Output= Matching Balloon
}}

==== Glow sticks ====
{{education feature|section=1}}
Dye can be used to craft [[Minecraft:glow stick]]s. There are no light gray or black variants.
{{Crafting
|nocat=1
|ignoreusage=1
|ingredients=[[Minecraft:Polyethylene]] +<br>[[Minecraft:Hydrogen Peroxide]] +<br>Matching [[Minecraft:Dye]] +<br>[[Minecraft:Luminol]]
|A1= Polyethylene
|B1= Hydrogen Peroxide
|C1= Polyethylene
|A2= Polyethylene
|B2= White Dye; Gray Dye; Brown Dye; Red Dye; Orange Dye; Yellow Dye; Lime Dye; Green Dye; Cyan Dye; Light Blue Dye; Blue Dye; Purple Dye; Magenta Dye; Pink Dye
|C2= Polyethylene
|A3= Polyethylene
|B3= Luminol
|C3= Polyethylene
|Output= Matching Glow Stick
}}

=== Banner patterns ===
{{main|Banner#Patterns}}
Dyes are used to add a banner pattern to a banner. When using a [[Minecraft:loom]], each pattern uses 1 dye, which determines the color of that pattern.

=== Dyeing water inside cauldrons ===
{{Anchor|Dyeing water}}
{{exclusive|bedrock|section=1}}
Water can be dyed in a cauldron by holding any dye in the hand and pressing {{Ctrl|use}} on a cauldron filled with water.

=== Dyeing armor ===
{{Calculator|armorColor}}
[[File:Leather armor dye graph.png|200px|thumb|A graph showing all combinations of two dyes on a [[leather tunic]] {{in|je}}.]]
[[Minecraft:Leather armor]], [[Minecraft:wolf armor]], [[Minecraft:leather horse armor]] can be dyed:
*{{IN|Bedrock|Console}}, armor is dyed by {{control|using}} it on a [[Minecraft:cauldron]] filled with dyed water. This consumes 1 layer of water but does not change the color of the water.
**The armor can be undyed by {{control|using}} it on a cauldron with undyed water. This does not change the water's color to the color of the armor, and changes the armor to have no dye color.
**Adding a dye to dyed water mixes the color of the water with the color of the dye, as 2 colors (using the formula below). The game does not remember which colors were placed into the cauldron. It just mixes the current color with the added dye, using the formula below. So, blue + pink + blue + pink is not the same as pink + blue + pink + blue.
*{{IN|java}}, it is possible to [[Minecraft:craft]] more than one dye with the armor, and armor can be dyed multiple times with previous colors affecting the outcome.
**Colored armor can be reverted to its original color by {{control|using}} it on a cauldron with undyed water.
**Since multiple dyes can be combined at once, more colors of dyed armor are obtainable in Survival. The exact number is 5,713,438. See [[Talk:Dye#Number of ways to dye leather armor|this discussion]] for more information.

Armor retains its [[Minecraft:Enchanting|enchantments]] and [[Minecraft:Anvil#Renaming|name]] when dyed or undyed.

; Mixing samples
{{JE}}:
:{{ItemSprite|Yellow Dye}} = {{Tint|leather-chestplate| #{{CalcDye| yellow=2 }} | code=1}}
:{{ItemSprite|Red Dye}} + {{ItemSprite|Blue Dye}} + {{ItemSprite|White Dye}} = {{Tint|leather-chestplate| #{{CalcDye| red=1 | blue=1 | white=1}} | code=1}}
:{{ItemSprite|Green Dye}} + {{ItemSprite|Red Dye}} + {{ItemSprite|Pink Dye}} = {{Tint|leather-chestplate| #{{CalcDye| green=1 | red=1 | pink=1}} | code=1}}

==== Dye mixing formula ====
Each edition of the game uses a specific formula for calculating the color of dyed armor. In this formula, the color of armor or cauldron water, and each dye color, in the RGB color model, has a red value, green value, and blue value.

{{Collapse
|title='''{{JE}}'''
|content=
In ''Java Edition'', dyes can be applied to a piece of leather armor using crafting.

Suppose each color is a point on the coordinate plane, <math>c=\left(r,g,b\right)</math>. This means that:
*<math>r</math> (the <span style="color:#f44;">'''red '''</span> component) is <math>c.x</math>
*<math>g</math> (the <span style="color:#0c0;">'''green'''</span> component) is <math>c.y</math>
*<math>b</math> (the <span style="color:#66f;">'''blue '''</span> component) is <math>c.z</math>

The formula to mix a list of colors, <math>c_{s}</math>, is this:
*<math>f\left(c_{s}\right)=\frac{\operatorname{mean}\left(c_{s}\right)\cdot\operatorname{mean}\left(\max\left(c_{s}.x,c_{s}.y,c_{s}.z\right)\right)}{\max\left(\operatorname{mean}\left(c_{s}.x\right),\operatorname{mean}\left(c_{s}.y\right),\operatorname{mean}\left(c_{s}.z\right)\right)}</math>

'''Notes:'''
*If the armor is dyed, its color is the first element in <math>c_{s}</math>.
*If the armor is undyed, it has no color.
*The color values of all of the dyes used in the crafting recipe make up the rest of the element in <math>c_{s}</math>.
*Since the [[Minecraft:crafting table]] grid only has 9 slots 1 to 8 dyes can be used, so <math>c_{s}</math> can have anywhere from 1 to 9 element. If the player uses the [[Minecraft:2×2 grid]], then only 1 to 3 dyes can be used, and <math>c_{s}</math> will have 1 to 4 element.

That formula could also be split up like this:
*<math>p_{max}\left(c\right)=\max\left(c.x,c.y,c.z\right)</math>
*<math>\frac{\operatorname{mean}\left(c_{s}\right)\cdot\operatorname{mean}\left(p_{max}\left(c_{s}\right)\right)}{p_{max}\left(\operatorname{mean}\left(c_{s}\right)\right)}</math>

In the split up formula, <math>\operatorname{mean}\left(p_{max}\left(c_{s}\right)\right)</math> is called the average maximum, and <math>p_{max}\left(\operatorname{mean}\left(c_{s}\right)\right)</math> is called the maximum average. The average maximum divided by the maximum average is the alpha factor.
*<math>\alpha=\frac{\operatorname{mean}\left(p_{max}\left(c_{s}\right)\right)}{p_{max}\left(\operatorname{mean}\left(c_{s}\right)\right)}</math>
*Or without the <math>p_{max}</math> function: <math>\frac{\operatorname{mean}\left(\max\left(c_{s}.x,c_{s}.y,c_{s}.z\right)\right)}{\max\left(\frac{\operatorname{total}\left(c_{s}.x\right)}{c_{s}.\operatorname{length}},\frac{\operatorname{total}\left(c_{s}.y\right)}{c_{s}.\operatorname{length}},\frac{\operatorname{total}\left(c_{s}.z\right)}{c_{s}.\operatorname{length}}\right)}</math>

For this formula, the exact order of [[Minecraft:w:floating point|floating point]] operations matters.
* <math>x\cdot\frac{y}{z}</math> is not the same as <math>\frac{x\cdot y}{z}</math>.
* <math>f_{a}\left(c_{s}\right)</math> cannot be written as <math>\operatorname{mean}\left(c_{s}\right)\cdot\frac{\operatorname{mean}\left(p_{max}\left(c_{s}\right)\right)}{p_{max}\left(\operatorname{mean}\left(c_{s}\right)\right)}</math>, because some mix operations would give slightly different colors.

}}
{{Collapse
|title='''{{BE}}'''
|content=
In ''Bedrock Edition'', dyes cannot be applied to armor directly and are applied to [[Minecraft:cauldron]] water instead. When a dye is used on undyed cauldron water, the water becomes dyed, and will have the color of that dye. When a dye is used on dyed cauldron water, a simple formula is
*<math>c_{next}=\frac{c_{current}+c_{dye}}{2}</math>

'''Notes:''' (when adding a single dye to dyed cauldron water)
*<math>c_{next}</math> is the color that the dyed water will have after the dye is added.
*<math>c_{current}</math> is the color of the dyed water before the dye is added.
*<math>c_{dye}</math> is the color of the dye.

''Bedrock Edition'' encodes each of these colors as an RGB vector, where each element is a float. The floats range from 0 to 1.
* The first element of the vector is the red component (R) of the color.
* The second element of the vector is the green component (G) of the color.
* The third element of the vector is the blue component (B) of the color.
* A value of <math>x</math> in any given component corresponds to a value of <math>y=\operatorname{round}\left(255\cdot x\right)</math> in the [[Minecraft:w:RGBA|RGBA]] format.
* The [[#Color values|color values]] of the dye items are stored in the RGBA format. To convert a value of <math>x</math> in the RGBA format to a float for the mixing algorithm, the formula <math>x=\frac{y}{255}</math> is used.

The color of the cauldron itself is stored in the ARGB32 format (a type of RGBA), meaning the effective formula is more like this:
*<math>\begin{bmatrix} c_{floatR} \\ c_{floatG} \\ c_{floatB} \end{bmatrix}=c_{next}=\frac{c_{current}+c_{dye}}{510}</math>
*<math>c_{next}=\begin{bmatrix} \operatorname{round}\left(255\cdot c_{floatR}\right) \\ \operatorname{round}\left(255\cdot c_{floatG}\right) \\ \operatorname{round}\left(255\cdot c_{floatB}\right) \end{bmatrix}</math>
*Where <math>c_{next}</math>, <math>c_{current}</math>, and <math>c_{dye}</math> are RGBA vectors, with an implied alpha = 255, in this format: <math>\begin{bmatrix} R \\ G \\ B \end{bmatrix}</math>.
}}

=== Dyeing sheep ===
Dyes can be {{control|use|text=used}} on sheep to change the color of the wool. Shearing a colored sheep drops the corresponding color of the wool, and the sheep retains the color when the wool regenerates. Killing colored sheep drops one block of wool with the corresponding color. [[Minecraft:Breeding]] colored sheep produce a lamb colored as one of the parent sheep, or a color resulting from the combination of both parents' colors. The color combining follows the same rules that dyes use – red and yellow sheep produce an orange lamb, but a blue and yellow sheep cannot create a green lamb. In case the colors of the colored sheep do not mix, the color of a lamb is randomly chosen between the two parents with equal chance. The unlimited reproduction of colored sheep makes dyeing and shearing sheep infinitely more efficient than just dyeing wool directly.

=== Dyeing collars ===
Dye can be used on a tamed [[Minecraft:wolf]] or [[Minecraft:cat]] to change the color of its collar from the default red to the color of the dye.

=== Dyeing signs ===
Dye can be {{control|used}} on a [[Minecraft:sign]] or a [[Minecraft:hanging sign]] to change the text color. {{IN|bedrock}}, [[Minecraft:ink sac]]s cannot be used for this purpose; black dye must be used to change the text to black. A sign cannot be dyed if its color is already the color of the dye. Attempting to dye it will not use the dye and will open the menu to edit the sign, if possible. A sign defaults to black text when placed.

=== Trading ===
Apprentice, journeyman, and expert-level shepherd [[Minecraft:villager]]s buy 12 of any of the dyes for an [[Minecraft:emerald]].
{{Trade uses|White Dye|Light Gray Dye|Gray Dye|Black Dye|Brown Dye|Red Dye|Orange Dye|Yellow Dye|Lime Dye|Green Dye|Cyan Dye|Light Blue Dye|Blue Dye|Purple Dye|Magenta Dye|Pink Dye}}

== Color values ==
The "color codes" are used to determine the color imparted on [[Minecraft:banner]]s, dyed [[Minecraft:leather armor]], [[Minecraft:leather horse armor]] and [[Minecraft:wolf armor]], [[Minecraft:wolf]] and [[Minecraft:cat]] collars, [[Minecraft:beacon]] beams, [[Minecraft:tropical fish]], [[Minecraft:sheep]], and [[Minecraft:firework star]]s. The hex value is shown in the extended tooltips of dyed armor; however, to set the color using an NBT data tag in a [[Minecraft:command]], the decimal value must be used instead. The color values for firework stars are slightly different. {{IN|java}}, sheep's wool uses different colors than the base dye values, appearing noticeably darker.

Color codes are usually encoded using the corresponding numeric ID, although e.g. [[Minecraft:sign]]s store the color name instead to represent text color.

<!--- Values are up to date as of Java Edition 1.20.4--->
{| class="wikitable sortable" style="margin:2px; border: 1px solid silver; text-align: left;" data-description="Data values"
! rowspan="2" |ID
! rowspan="2" |Name
! colspan="2" style="text-align:center" |Color code{{note|Used for banners, dyed armor, wolf and cat collars, and beacon beams, as well as sheep's wool {{in|bedrock}}.}}
! colspan="2" style="text-align:center" |Firework color code
! colspan="2" style="text-align:center" |Sheep color code (''JE'')
|-
! Dec
! <abbr title="Hexadecimal color code">Hex</abbr>
! Dec
! <abbr title="Hexadecimal color code">Hex</abbr>
! Dec
! <abbr title="Hexadecimal color code">Hex</abbr>
|-
| style="text-align:center" |0||<code>white</code>||16383998{{only|je|short=1}}<br>15790320{{only|be|short=1}}||{{color|#F9FFFE}}{{only|je|short=1}}<br>{{color|#F0F0F0}}{{only|be|short=1}} || 15790320 || {{color|#F0F0F0}} || 15132390 || {{color|#E6E6E6}}
|-
| style="text-align:center" |1||<code>orange</code>||16351261||{{color|#F9801D}} || 15435844 || {{color|#EB8844}} || 12214293 || {{color|#BA6015}}
|-
| style="text-align:center" |2||<code>magenta</code>||13061821||{{color|#C74EBD}} || 12801229 || {{color|#C354CD}} || 9779853 || {{color|#953A8D}}
|-
| style="text-align:center" |3||<code>light_blue</code>||3847130||{{color|#3AB3DA}} || 6719955 || {{color|#6689D3}} || 2852515 || {{color|#2B86A3}}
|-
| style="text-align:center" |4||<code>yellow</code>||16701501||{{color|#FED83D}} || 14602026 || {{color|#DECF2A}} || 12493357 || {{color|#BEA22D}}
|-
| style="text-align:center" |5||<code>lime</code>||8439583||{{color|#80C71F}} || 4312372 || {{color|#41CD34}} || 6329623 || {{color|#609517}}
|-
| style="text-align:center" |6||<code>pink</code>||15961002||{{color|#F38BAA}} || 14188952 || {{color|#D88198}} || 11954303 || {{color|#B6687F}}
|-
| style="text-align:center" |7||<code>gray</code>||4673362||{{color|#474F52}} || 4408131 || {{color|#434343}} || 3488573 || {{color|#353B3D}}
|-
| style="text-align:center" |8||<code>light_gray</code>||10329495||{{color|#9D9D97}} || 11250603 || {{color|#ABABAB}} || 7697777 || {{color|#757571}}
|-
| style="text-align:center" |9||<code>cyan</code>||1481884||{{color|#169C9C}} || 2651799 || {{color|#287697}} || 1078645 || {{color|#107575}}
|-
| style="text-align:center" |10||<code>purple</code>||8991416||{{color|#8932B8}} || 8073150 || {{color|#7B2FBE}} || 6694282 || {{color|#66258A}}
|-
| style="text-align:center" |11||<code>blue</code>||3949738||{{color|#3C44AA}} || 2437522 || {{color|#253192}} || 2962303 || {{color|#2D337F}}
|-
| style="text-align:center" |12||<code>brown</code>||8606770||{{color|#835432}} || 5320730 || {{color|#51301A}} || 6438693 || {{color|#623F25}}
|-
| style="text-align:center" |13||<code>green</code>||6192150||{{color|#5E7C16}} || 3887386 || {{color|#3B511A}} || 4611344 || {{color|#465D10}}
|-
| style="text-align:center" |14||<code>red</code>||11546150||{{color|#B02E26}} || 11743532 || {{color|#B3312C}} || 8659484 || {{color|#84221C}}
|-
| style="text-align:center" |15||<code>black</code>||1908001||{{color|#1D1D21}} || 1973019 || {{color|#1E1B1B}} || 1381656 || {{color|#151518}}
|}

{{notelist}}

== Data values ==
=== ID ===
{{JE}}:
{{ID table
|edition=java
|showforms=y
|generatetranslationkeys=y
|displayname=White Dye
|spritetype=item
|nameid=white_dye
|form=item}}
{{ID table
|displayname=Orange Dye
|spritetype=item
|nameid=orange_dye
|form=item}}
{{ID table
|displayname=Magenta Dye
|spritetype=item
|nameid=magenta_dye
|form=item}}
{{ID table
|displayname=Light Blue Dye
|spritetype=item
|nameid=light_blue_dye
|form=item}}
{{ID table
|displayname=Yellow Dye
|spritetype=item
|nameid=yellow_dye
|form=item}}
{{ID table
|displayname=Lime Dye
|spritetype=item
|nameid=lime_dye
|form=item}}
{{ID table
|displayname=Pink Dye
|spritetype=item
|nameid=pink_dye
|form=item}}
{{ID table
|displayname=Gray Dye
|spritetype=item
|nameid=gray_dye
|form=item}}
{{ID table
|displayname=Light Gray Dye
|spritetype=item
|nameid=light_gray_dye
|form=item}}
{{ID table
|displayname=Cyan Dye
|spritetype=item
|nameid=cyan_dye
|form=item}}
{{ID table
|displayname=Purple Dye
|spritetype=item
|nameid=purple_dye
|form=item}}
{{ID table
|displayname=Blue Dye
|spritetype=item
|nameid=blue_dye
|form=item}}
{{ID table
|displayname=Brown Dye
|spritetype=item
|nameid=brown_dye
|form=item}}
{{ID table
|displayname=Green Dye
|spritetype=item
|nameid=green_dye
|form=item}}
{{ID table
|displayname=Red Dye
|spritetype=item
|nameid=red_dye
|form=item}}
{{ID table
|displayname=Black Dye
|spritetype=item
|nameid=black_dye
|form=item
|foot=1}}

{{BE}}:
{{ID table
|edition=bedrock
|showaliasids=y
|shownumericids=y
|showforms=y
|notshowbeitemforms=y
|generatetranslationkeys=y
|displayname=White Dye
|spritetype=item
|nameid=white_dye
|aliasid=dye / 19
|id=410
|form=item
|translationkey=item.dye.white_new.name}}
{{ID table
|displayname=Orange Dye
|spritetype=item
|nameid=orange_dye
|aliasid=dye / 14
|id=409
|form=item
|translationkey=item.dye.orange.name}}
{{ID table
|displayname=Magenta Dye
|spritetype=item
|nameid=magenta_dye
|aliasid=dye / 13
|id=408
|form=item
|translationkey=item.dye.magenta.name}}
{{ID table
|displayname=Light Blue Dye
|spritetype=item
|nameid=light_blue_dye
|aliasid=dye / 12
|id=407
|form=item
|translationkey=item.dye.lightBlue.name}}
{{ID table
|displayname=Yellow Dye
|spritetype=item
|nameid=yellow_dye
|aliasid=dye / 11
|id=406
|form=item
|translationkey=item.dye.yellow.name}}
{{ID table
|displayname=Lime Dye
|spritetype=item
|nameid=lime_dye
|aliasid=dye / 10
|id=405
|form=item
|translationkey=item.dye.lime.name}}
{{ID table
|displayname=Pink Dye
|spritetype=item
|nameid=pink_dye
|aliasid=dye / 9
|id=404
|form=item
|translationkey=item.dye.pink.name}}
{{ID table
|displayname=Gray Dye
|spritetype=item
|nameid=gray_dye
|aliasid=dye / 8
|id=403
|form=item
|translationkey=item.dye.gray.name}}
{{ID table
|displayname=Light Gray Dye
|spritetype=item
|nameid=light_gray_dye
|aliasid=dye / 7
|id=402
|form=item
|translationkey=item.dye.silver.name}}
{{ID table
|displayname=Cyan Dye
|spritetype=item
|nameid=cyan_dye
|aliasid=dye / 6
|id=401
|form=item
|translationkey=item.dye.cyan.name}}
{{ID table
|displayname=Purple Dye
|spritetype=item
|nameid=purple_dye
|aliasid=dye / 5
|id=400
|form=item
|translationkey=item.dye.purple.name}}
{{ID table
|displayname=Blue Dye
|spritetype=item
|nameid=blue_dye
|aliasid=dye / 18
|id=399
|form=item
|translationkey=item.dye.blue_new.name}}
{{ID table
|displayname=Brown Dye
|spritetype=item
|nameid=brown_dye
|aliasid=dye / 17
|id=398
|form=item
|translationkey=item.dye.brown_new.name}}
{{ID table
|displayname=Green Dye
|spritetype=item
|nameid=green_dye
|aliasid=dye / 2
|id=397
|form=item
|translationkey=item.dye.green.name}}
{{ID table
|displayname=Red Dye
|spritetype=item
|nameid=red_dye
|aliasid=dye / 1
|id=396
|form=item
|translationkey=item.dye.red.name}}
{{ID table
|displayname=Black Dye
|spritetype=item
|nameid=black_dye
|aliasid=dye / 16
|id=395
|form=item
|translationkey=item.dye.black_new.name
|foot=1}}

== Sounds ==
{{edition|java}}:
{{SoundTable
| type = java
| {{SoundLine
|sound =Dye.ogg
|subtitle=Dye stains
|source=block
|description=When dye is used on a [[Minecraft:sign]]
|id=item.dye.use
|translationkey=subtitles.item.dye.use
|volume=1.0
|pitch=1.0/0.9/0.95/1.1
|distance=16}}
| {{SoundLine
|subtitle=Dye stains
|source=player
|description=When dye is used on a [[Minecraft:sheep]]
|id=item.dye.use
|translationkey=subtitles.item.dye.use
|volume=1.0
|pitch=1.0/0.9/0.95/1.1
| distance = 16
}}
}}

{{edition|bedrock}}:
{{SoundTable
| type = bedrock
| {{SoundLine
| sound =Dye.ogg
|source=sound
|description=When dye is used on a sign
|id=sign.dye.use
|volume=1.0
|pitch=1.0}}
| {{SoundLine
|rowspan=3
|sound=Water Splash Old.ogg
|source=block
|description=When dye is added to a cauldron
|id=cauldron.adddye
|volume=0.1
|pitch=1.0}}
| {{SoundLine
|source=block
|description=When armor is dyed using a cauldron
|id=cauldron.dyearmor
|volume=0.1
|pitch=1.0}}
| {{SoundLine
|source=block
|description=When dye is removed from armor using a cauldron
|id=cauldron.cleanarmor
|volume=0.1
| pitch = 1.0
}}
}}

== Achievements ==
{{load achievements|Rainbow Collection;Tie dye outfit;Change of sheets}}

== Videos ==
{{Video note|These videos are outdated, as it does not include details of the [[Minecraft:Java Edition 1.7.2|1.7.2]] update's changes to the dyeing system/production chain.}}

{{yt|8YD7oauNZHE|align=inline}}
{{yt|7tETaRt7STM|align=inline}}

== History ==
{{cleanup|section=1|this section should only be about information that applies to most dyes; those specific to one dye (or a few dyes) should only be present on that specific dye's dedicated page}}
=== Development ===
{{HistoryTable
|{{HistoryLine||January 3, 2011|link=https://web.archive.org/web/0/http://notch.tumblr.com/post/2582321901/2011-here-we-go|Notch mentions adding a "paint" feature if he can figure out how.}}
|{{HistoryLine||January 10, 2011|link=https://www.youtube.com/watch?v=cBF2ugTzXqQ&t=181s|[[File:Red Dye (pre-release).png|32px]] Shown rose red in development as part of [[Minecraft: The Story of Mojang]].<ref group="note">Supposed time when fragment was filmed. Based on the modified date of client.jar/gui/trap.png in [[Minecraft:Beta 1.2]].</ref>}}
}}

=== ''Java Edition'' ===
{{HistoryTable
|{{HistoryLine|java beta}}
|{{HistoryLine||1.2|[[File:Ink Sac JE1 BE1.png|32px]] [[File:Red Dye JE1 BE1.png|32px]] [[File:Green Dye JE1 BE1.png|32px]] [[File:Cocoa Beans JE1 BE1.png|32px]] [[File:Lapis Lazuli JE1 BE1.png|32px]] [[File:Purple Dye JE1 BE1.png|32px]] [[File:Cyan Dye JE1 BE1.png|32px]] [[File:Light Gray Dye JE1 BE1.png|32px]] [[File:Gray Dye JE1 BE1.png|32px]] [[File:Pink Dye JE1 BE1.png|32px]] [[File:Lime Dye JE1 BE1.png|32px]] [[File:Yellow Dye JE1 BE1.png|32px]] [[File:Light Blue Dye JE1 BE1.png|32px]] [[File:Magenta Dye JE1 BE1.png|32px]] [[File:Orange Dye JE1 BE1.png|32px]] [[File:Bone Meal JE1 BE1.png|32px]] Added dyes.
|[[File:Black Dye (Recreated).png|32px]] [[File:Red Dye (pre-release).png|32px]] [[File:Green Dye (Recreated).png|32px]] [[File:Brown Dye (Recreated).png|32px]] [[File:Blue Dye (Recreated).png|32px]] [[File:Purple Dye (Recreated).png|32px]] [[File:Cyan Dye (Recreated).png|32px]] [[File:Light Gray Dye (Recreated).png|32px]] [[File:Gray Dye (Recreated).png|32px]] [[File:Pink Dye (Recreated).png|32px]] [[File:Lime Dye (Recreated).png|32px]] [[File:Yellow Dye (Recreated).png|32px]] [[File:Light Blue Dye (Recreated).png|32px]] [[File:Magenta Dye (Recreated).png|32px]] [[File:Orange Dye (Recreated).png|32px]] [[File:White Dye (Recreated).png|32px]] Leftovers of old textures can be seen in [[Minecraft:items.png]] with 100% opacity. The white dye texture was later reused for [[Minecraft:sugar]].
| The colors were as follows:
{{:Color/Java Edition dye colors before 1.4.3}}
}}
|{{HistoryLine|java}}
|{{HistoryLine||1.1|dev=11w49a|[[Minecraft:Sheep]] can now regrow their [[Minecraft:wool]] by eating [[Minecraft:grass block|grass]]. Dyed sheep regrow wool in their new color.}}
|{{HistoryLine||1.4.2|dev=12w34a|Added the ability to dye leather [[Minecraft:armor]] and [[Minecraft:wolf]] collars.}}
|{{HistoryLine||1.4.4|dev=1.4.3|Color codes have been changed. The colors of red, brown, blue, purple, cyan, pink, light blue, magenta and orange were adjusted a little vividly.
{{:Color/Java Edition dye color changes in 1.4.3}}}}
|{{HistoryLine||1.6.1|dev=13w19a|[[Minecraft:Stained clay]] can now be crafted using dyes.}}
|{{HistoryLine||1.7.2|dev=13w36a|With the addition of new [[Minecraft:flower]]s, many secondary and tertiary dyes are now primary dyes.}}
|{{HistoryLine|||dev=13w41a|[[Minecraft:Stained glass]] can now be crafted using dyes.}}
|{{HistoryLine||1.8|dev=14w30a|Added [[Minecraft:banner]]s, which can be dyed.}}
|{{HistoryLine||1.9|dev=15w34a|Added [[Minecraft:shield]]s, which can be dyed indirectly by applying a matching [[Minecraft:banner]].}}
|{{HistoryLine||1.11|dev=16w39b|Dyes are now used to change the color of [[Minecraft:shulker box]]es.}}
|{{HistoryLine||1.12|dev=17w06a|Dyes are now used to craft [[Minecraft:concrete powder]].
|Color codes have been changed. All colors are adjusted more vividly. The changes were as follows:
{{:Color/Java Edition dye color changes in 17w06a}}
|Light blue dye, stained glass, stained glass panes, and firework stars did not change colors in this update.<ref name="unchanged dyes">{{Bug|MC-214643}}<br>{{Bug|MC-214641}}<br>{{Bug|MC-305712}}</ref>
}}
|{{HistoryLine|||dev=17w15a|Dyes can now apply color to white [[Minecraft:bed]]s.}}
|{{HistoryLine||1.14|dev=18w43a
|[[Minecraft:Glass pane]]s and [[Minecraft:carpet]]s can now be dyed.
|[[File:Light Gray Dye JE2 BE2.png|32px]] [[File:Gray Dye JE2 BE2.png|32px]] [[File:Red Dye JE3 BE3.png|32px]] [[File:Orange Dye JE2 BE2.png|32px]] [[File:Yellow Dye JE2 BE2.png|32px]] [[File:Lime Dye JE2 BE2.png|32px]] [[File:Green Dye JE3 BE3.png|32px]] [[File:Cyan Dye JE2 BE2.png|32px]] [[File:Light Blue Dye JE2 BE2.png|32px]] [[File:Purple Dye JE2 BE2.png|32px]] [[File:Magenta Dye JE2 BE2.png|32px]] [[File:Pink Dye JE2 BE2.png|32px]] The textures of light gray, gray, red, orange, yellow, lime, green, cyan, light blue, purple, magenta, and pink dyes, have been changed. These changed textures still do not reflect the updated colors from 1.12.<ref name="unchanged dyes"></ref>
|[[File:White Dye JE1 BE1.png|32px]] [[File:Black Dye JE1 BE1.png|32px]] [[File:Brown Dye JE1 BE1.png|32px]] [[File:Blue Dye JE1 BE1.png|32px]] Added white, black, brown, and blue dyes as their own items.}}
|{{HistoryLine|||dev=18w44a|The color of the text on [[Minecraft:sign]]s can now be changed with dye.|Dyes can now be used to dye [[Minecraft:cat]] collars.}}
|{{HistoryLine|||dev=19w05a|Added the [[Minecraft:wandering trader]], which can sell any type of dye.}}
|{{HistoryLine|||dev=19w11a|All 16 types of dyes can now be [[Minecraft:trading|bought]] by shepherd villagers.}}
|{{HistoryLine||1.16.2|dev=pre2|Reversed the order of dyes to match other colored items in the [[Minecraft:Creative inventory]].<ref name="reverse dye">{{Bug|MC-136553}}</ref>}}
|{{HistoryLine||1.17|dev=20w45a|Added [[Minecraft:candle]]s, which can be dyed.}}
|{{HistoryLine|||dev=21w03a|Added a sound for applying dyes.}}
|{{HistoryLine|||dev=21w19a|Candles can no longer be dyed.}}
|{{HistoryLine|||dev=pre1|Candles can now once again be dyed.}}
|{{HistoryLine||1.19.3|exp=Update 1.20|dev=22w42a|The color of the text on [[Minecraft:hanging sign]]s can now be changed with dye.}}
|{{HistoryLine||1.20.5|dev=24w09a|[[Minecraft:Wolf armor]] can now be dyed.}}
|{{HistoryLine||1.21.2|dev=24w38a|[[Minecraft:Bundle]]s can now be dyed.}}
|{{HistoryLine||1.21.6|dev=25w15a|Added [[Minecraft:harness]]es, which can be dyed.}}
|{{HistoryLine||1.21.9|dev=25w31a|[[File:White Dye BE2.png|32px]] [[File:Light Gray BE3.png|32px]] [[File:Gray Dye BE3.png|32px]] [[File:Black Dye BE2.png|32px]] [[File:Brown Dye BE2.png|32px]] [[File:Red Dye BE4.png|32px]] [[File:Orange Dye BE3.png|32px]] [[File:Yellow Dye BE3.png|32px]] [[File:Lime Dye BE3.png|32px]] [[File:Green Dye BE4.png|32px]] [[File:Cyan Dye BE3.png|32px]] [[File:Light Blue Dye BE3.png|32px]] [[File:Blue Dye BE2.png|32px]] [[File:Purple Dye BE3.png|32px]] [[File:Magenta Dye BE3.png|32px]] [[File:Pink Dye BE3.png|32px]] The textures of all dyes have been changed. They still do not reflect the updated colors from 1.12.<ref name="unchanged dyes"></ref>}}
}}

=== ''Bedrock Edition'' ===
{{HistoryTable
|{{HistoryLine|pocket alpha}}
|{{HistoryLine||v0.3.0|[[File:Bone Meal JE1 BE1.png|32px]] [[File:Light Gray Dye JE1 BE1.png|32px]] [[File:Gray Dye JE1 BE1.png|32px]] [[File:Ink Sac JE1 BE1.png|32px]] [[File:Cocoa Beans JE1 BE1.png|32px]] [[File:Red Dye JE1 BE1.png|32px]] [[File:Orange Dye JE1 BE1.png|32px]] [[File:Yellow Dye JE1 BE1.png|32px]] [[File:Lime Dye JE1 BE1.png|32px]] [[File:Green Dye JE1 BE1.png|32px]] [[File:Cyan Dye JE1 BE1.png|32px]] [[File:Light Blue Dye JE1 BE1.png|32px]] [[File:Lapis Lazuli JE1 BE1.png|32px]] [[File:Purple Dye JE1 BE1.png|32px]] [[File:Magenta Dye JE1 BE1.png|32px]] [[File:Pink Dye JE1 BE1.png|32px]] Added dyes. Only [[Minecraft:dandelion yellow]] and [[Minecraft:lapis lazuli]] are currently obtainable and have functionality.}}
|{{HistoryLine||v0.4.0|All available dyes, excluding bone meal, can now be used to craft their respective [[Minecraft:wool]] color.}}
|{{HistoryLine||v0.8.0|dev=build 3|All new [[Minecraft:flower]]s can now be [[Minecraft:craft]]ed into dyes. Because of this, many secondary and tertiary dyes are now primary dyes.}}
|{{HistoryLine||v0.9.0|dev=build 11|[[Minecraft:Stained clay]] can now be crafted using dyes.}}
|{{HistoryLine||v0.11.0|dev=build 1|Added the ability to dye [[Minecraft:wolf]] collars.}}
|{{HistoryLine||v0.14.0|dev=build 1|[[Minecraft:Cauldron]]s now used for leather dyeing, by applying a dye to a [[Minecraft:water]]-filled cauldron.}}
|{{HistoryLine|pocket}}
|{{HistoryLine||1.0.0|dev=alpha 0.17.0.1|Added a ''Dye'' button for [[Minecraft:sheep]].
|Added [[Minecraft:shulker]]s, which can be dyed.
|Added [[Minecraft:stained glass]]. Stained glass cannot be [[Minecraft:craft]]ed, but purple glass generates in [[Minecraft:end cities]].}}
|{{HistoryLine||1.1.0|dev=alpha 1.1.0.0|Dyes can now apply color to a white [[Minecraft:bed]]s.
|Dyes are now used to craft [[Minecraft:concrete powder]].
|The color palette has been changed.}}
|{{HistoryLine|bedrock}}
|{{HistoryLine||1.2.0|dev=beta 1.2.0.2|Dyes can now be used for [[Minecraft:banner]] crafting.
|Dyes can now be used to craft [[Minecraft:firework star]]s.
|[[Minecraft:Stained glass]] is now [[Minecraft:craft]]able, using dyes.}}
|{{HistoryLine||1.4.0|dev=beta 1.2.20.1|[[Minecraft:Lime dye]] can now be obtained from smelting [[Minecraft:sea pickle]]s.
|Dyes can now used to craft [[Minecraft:glow stick]]s and [[Minecraft:balloon]]s.}}
|{{HistoryLine||1.8.0|dev=beta 1.8.0.8|Dyes can now be used to dye [[Minecraft:cat]] collars.}}
|{{HistoryLine|||dev=beta 1.8.0.10|[[File:White Dye JE1 BE1.png|32px]] [[File:Black Dye JE1 BE1.png|32px]] [[File:Brown Dye JE1 BE1.png|32px]] [[File:Blue Dye JE1 BE1.png|32px]] Added [[Minecraft:white dye|white]], [[Minecraft:brown dye|brown]], [[Minecraft:black dye|black]] and [[Minecraft:blue dye]]s, which can be crafted from [[Minecraft:lapis lazuli]], [[Minecraft:bone meal]], [[Minecraft:cocoa beans]] and [[Minecraft:ink sac]]s. This, however, the later four still use as dyes.<ref>{{Bug|MCPE-42473}}</ref>
|"Rose Red", "Dandelion Yellow" and "Cactus Green" have been renamed to "Red Dye", "Yellow Dye" and "Green Dye", respectively.}}
|{{HistoryLine||1.9.0|dev=beta 1.9.0.0|Blue and white dye can now be obtained from [[Minecraft:cornflower]]s and [[Minecraft:lily of the valley]]s.}}
|{{HistoryLine||1.10.0|dev=beta 1.10.0.3|[[Minecraft:Glass pane]]s and [[Minecraft:carpet]]s can now be dyed.
|Only a single dye is now required to apply a banner pattern in a [[Minecraft:loom]].
|Various dyes except black dye, white dye, brown dye and blue dye are now [[Minecraft:trading|sold]] by [[Minecraft:wandering trader]]s.
|[[File:Light Gray Dye JE2 BE2.png|32px]] [[File:Gray Dye JE2 BE2.png|32px]] [[File:Red Dye JE3 BE3.png|32px]] [[File:Orange Dye JE2 BE2.png|32px]] [[File:Yellow Dye JE2 BE2.png|32px]] [[File:Lime Dye JE2 BE2.png|32px]] [[File:Green Dye JE3 BE3.png|32px]] [[File:Cyan Dye JE2 BE2.png|32px]] [[File:Light Blue Dye JE2 BE2.png|32px]] [[File:Purple Dye JE2 BE2.png|32px]] [[File:Magenta Dye JE2 BE2.png|32px]] [[File:Pink Dye JE2 BE2.png|32px]] The textures of all dyes except black, white, brown and blue have been changed. These changed textures still do not reflect the updated colors from 1.1.}}
|{{HistoryLine||1.11.0|dev=beta 1.11.0.4|Dye can now be [[Minecraft:trading|sold]] to shepherd [[Minecraft:villager]]s.}}
|{{HistoryLine||1.16.210|dev=beta 1.16.210.59|The color of the text on [[Minecraft:sign]]s can now be changed with dye.}}
|{{HistoryLine|||dev=beta 1.16.210.60|The ability to dye the color of the text on [[Minecraft:sign]]s was temporarily removed.}}
|{{HistoryLine||1.16.220|dev=beta 1.16.220.50|The color of the text on [[Minecraft:sign]]s can now be changed with dye again.}}
|{{HistoryLine||1.17.10|dev=beta 1.17.10.22|Added [[Minecraft:candle]]s, which can be dyed.}}
|{{HistoryLine||1.20.80|dev=Preview 1.20.80.20|[[Minecraft:Wolf armor]] can now be dyed.}}
|{{HistoryLine||1.21.40|dev=Preview 1.21.40.22|[[Minecraft:Bundle]]s can now be dyed.}}
|{{HistoryLine||1.21.80|dev=Preview 1.21.80.25|exp=Drop 2 2025|Added [[Minecraft:harness]]es, which can be dyed.}}
|{{HistoryLine||1.21.111|dev=Preview 1.21.110.20|[[File:White Dye BE2.png|32px]] [[File:Light Gray BE3.png|32px]] [[File:Gray Dye BE3.png|32px]] [[File:Black Dye BE2.png|32px]] [[File:Brown Dye BE2.png|32px]] [[File:Red Dye BE4.png|32px]] [[File:Orange Dye BE3.png|32px]] [[File:Yellow Dye BE3.png|32px]] [[File:Lime Dye BE3.png|32px]] [[File:Green Dye BE4.png|32px]] [[File:Cyan Dye BE3.png|32px]] [[File:Light Blue Dye BE3.png|32px]] [[File:Blue Dye BE2.png|32px]] [[File:Purple Dye BE3.png|32px]] [[File:Magenta Dye BE3.png|32px]] [[File:Pink Dye BE3.png|32px]] The textures of all dyes have been changed. They still do not reflect the updated colors from 1.1.}}
}}

=== Legacy Console Edition ===
{{HistoryTable
|{{HistoryLine|console}}
|{{HistoryLine||xbox=TU1|xbone=CU1|ps3=1.00|psvita=1.00|ps4=1.00|wiiu=Patch 1|switch=1.0.1|[[File:Bone Meal JE1 BE1.png|32px]] [[File:Light Gray Dye JE1 BE1.png|32px]] [[File:Gray Dye JE1 BE1.png|32px]] [[File:Ink Sac JE1 BE1.png|32px]] [[File:Cocoa Beans JE1 BE1.png|32px]] [[File:Red Dye JE1 BE1.png|32px]] [[File:Orange Dye JE1 BE1.png|32px]] [[File:Yellow Dye JE1 BE1.png|32px]] [[File:Lime Dye JE1 BE1.png|32px]] [[File:Green Dye JE1 BE1.png|32px]] [[File:Cyan Dye JE1 BE1.png|32px]] [[File:Light Blue Dye JE1 BE1.png|32px]] [[File:Lapis Lazuli JE1 BE1.png|32px]] [[File:Purple Dye JE1 BE1.png|32px]] [[File:Magenta Dye JE1 BE1.png|32px]] [[File:Pink Dye JE1 BE1.png|32px]] Added dyes.}}
|{{HistoryLine||xbox=TU9|[[File:Cocoa Beans JE3 BE2.png|32px]] The texture of cocoa beans has been changed.}}
|{{HistoryLine||xbox=TU14|xbone=CU1|ps3=1.04|psvita=1.00|ps4=1.00|wiiu=Patch 1|switch=1.0.1|Added the ability to dye leather [[Minecraft:armor]] and [[Minecraft:wolf]] collars.}}
|{{HistoryLine||xbox=TU19|xbone=CU7|ps3=1.12|psvita=1.12|ps4=1.12|[[Minecraft:Stained clay]] can now be crafted using dyes.}}
|{{HistoryLine||xbox=TU25|xbone=CU14|ps3=1.17|psvita=1.17|ps4=1.17|[[Minecraft:Stained glass]] can now be crafted using dyes.}}
|{{HistoryLine||xbox=TU31|xbone=CU19|ps3=1.22|psvita=1.22|ps4=1.22|wiiu=Patch 3|switch=1.0.1|With the addition of new [[Minecraft:flower]]s, many secondary and tertiary dyes are now primary dyes.|As cleric [[Minecraft:villager]]s now sell lapis lazuli, all dyes have become fully renewable.}}
|{{HistoryLine||xbox=TU43|xbone=CU33|ps3=1.36|psvita=1.36|ps4=1.36|wiiu=Patch 13|switch=1.0.1|Added [[Minecraft:banner]]s, which can be dyed.}}
|{{HistoryLine||xbox=TU53|xbone=CU43|ps3=1.49|psvita=1.49|ps4=1.50|wiiu=Patch 23|switch=1.0.3|Dyes are now used to change the color of [[Minecraft:shulker box]]es.|Dyes are now used to craft [[Minecraft:concrete powder]].}}
|{{HistoryLine||xbox=TU60|xbone=CU51|ps3=1.64|psvita=1.64|ps4=1.64|wiiu=Patch 30|switch=1.0.11|Dyes can now be used to dye [[Minecraft:leather horse armor]].|Dyes can now be used to change the water color in a [[Minecraft:cauldron]] to dye leather [[Minecraft:armor]].}}
|{{HistoryLine||xbox=none|xbone=none|ps3=none|psvita=none|ps4=1.83|wiiu=none|switch=none|[[File:White Dye JE1 BE1.png|32px]] [[File:Black Dye JE1 BE1.png|32px]] [[File:Brown Dye JE1 BE1.png|32px]] [[File:Blue Dye JE1 BE1.png|32px]] Added [[Minecraft:white dye|white]], [[Minecraft:black dye|black]], [[Minecraft:brown dye|brown]], and [[Minecraft:blue dye|blue]] dyes, which can crafted from [[Minecraft:bone meal]], [[Minecraft:ink sac]], [[Minecraft:cocoa beans]], and [[Minecraft:lapis lazuli]].
|"Rose Red", "Dandelion Yellow" and "Cactus Green" have been renamed to "Red Dye", "Yellow Dye" and "Green Dye", respectively.|Dyes can now be used to dye [[Minecraft:cat]] collars.}}
|{{HistoryLine||ps4=1.90|[[File:Bone Meal JE2 BE2.png|32px]] [[File:Light Gray Dye JE2 BE2.png|32px]] [[File:Gray Dye JE2 BE2.png|32px]] [[File:Ink Sac JE2 BE2.png|32px]] [[File:Cocoa Beans JE4 BE3.png|32px]] [[File:Red Dye JE2 BE2.png|32px]] [[File:Orange Dye JE2 BE2.png|32px]] [[File:Yellow Dye JE2 BE2.png|32px]] [[File:Lime Dye JE2 BE2.png|32px]] [[File:Green Dye JE2 BE2.png|32px]] [[File:Cyan Dye JE2 BE2.png|32px]] [[File:Light Blue Dye JE2 BE2.png|32px]] [[File:Lapis Lazuli JE2 BE2.png|32px]] [[File:Purple Dye JE2 BE2.png|32px]] [[File:Magenta Dye JE2 BE2.png|32px]] [[File:Pink Dye JE2 BE2.png|32px]] The textures of bone meal, light gray, gray, ink sac, cocoa beans, red, orange, yellow, lime, green, cyan, light blue, lapis lazuli, purple, magenta, and pink dyes have been changed.|[[Minecraft:Glass pane]]s and [[Minecraft:carpet]]s can now be dyed.|Only a single dye is now required to apply a banner pattern in a [[Minecraft:loom]].}}
}}

=== ''New Nintendo 3DS Edition'' ===
{{HistoryTable
|{{HistoryLine|new 3ds}}
|{{HistoryLine||0.1.0|[[File:Bone Meal JE1 BE1.png|32px]] [[File:Light Gray Dye JE1 BE1.png|32px]] [[File:Gray Dye JE1 BE1.png|32px]] [[File:Ink Sac JE1 BE1.png|32px]] [[File:Cocoa Beans JE3 BE2.png|32px]] [[File:Red Dye JE1 BE1.png|32px]] [[File:Orange Dye JE1 BE1.png|32px]] [[File:Yellow Dye JE1 BE1.png|32px]] [[File:Lime Dye JE1 BE1.png|32px]] [[File:Green Dye JE1 BE1.png|32px]] [[File:Cyan Dye JE1 BE1.png|32px]] [[File:Light Blue Dye JE1 BE1.png|32px]] [[File:Lapis Lazuli JE1 BE1.png|32px]] [[File:Purple Dye JE1 BE1.png|32px]] [[File:Magenta Dye JE1 BE1.png|32px]] [[File:Pink Dye JE1 BE1.png|32px]] Added dyes from [[Minecraft:Pocket Edition v0.15.4 alpha]].}}
}}

<gallery class=pixel-image>
Pre-release dyes.png|Pre-release dye textures hidden within [[Minecraft:Items.png]].
</gallery>

== Issues ==
{{issue list}}

== Trivia ==
*Players can obtain each one of every color with 1 cocoa bean, 2 dandelions/wildflowers or 1 sunflower, 2 ink sacs, 3 cactuses, 4 lapis lazuli or 4 cornflowers, 4 small red flowers (for example, 4 poppies) or 2 rose bushes, and 6 bone meal.
*In ''Bedrock Edition'', tertiary colors, along with their regular crafting recipes, can be crafted with primary colors. For example, magenta can be crafted with one red dye and two white dyes.

== Notes ==
{{notelist}}

== References ==
{{reflist}}

== External links ==
*Tools for calculating leather dye combination: [https://minecraft.tools/en/armor.php minecraft.tools] (webapp); [https://github.com/pudquick/pyMCdyes/ pyMCDyes] (open-source Python script, outdated); [https://anrar4.github.io/DyeLeatherArmor/ DyeLeatherArmor]: a tool for calculating an exact crafting recipe for any sRGB color

== Navigation ==
{{Navbox dyed block}}
{{Navbox items|Ingredients}}

[[Category:Dyes|*]]

[[Minecraft:de:Farbstoff]]
[[Minecraft:es:Tinte]]
[[Minecraft:fr:Teinture]]
[[Minecraft:it:Colorante]]
[[Minecraft:ja:染料]]
[[Minecraft:ko:염료]]
[[Minecraft:lzh:染]]
[[Minecraft:nl:Kleurstof]]
[[Minecraft:pl:Barwniki]]
[[Minecraft:pt:Corante]]
[[Minecraft:ru:Краситель]]
[[Minecraft:th:สีย้อม]]
[[Minecraft:uk:Барвник]]
[[Minecraft:zh:染料]]