Guide
Tannins and tanks: what does it actually mean?
Tea-coloured water, blackwater, humic acids - what tannins are, where they come from, and whether they matter.
- What they are: Tannins are natural organic compounds - primarily humic and fulvic acids - that leach from wood, leaves, peat, and botanicals, tinting water yellow, amber, or brown.
- Are they harmful? No. Tannins are non-toxic to fish, plants, and invertebrates. Many popular species evolved in tannin-rich water.
- What they actually do: Tannins can gently lower pH, soften water, and have mild antibacterial properties - which is why blackwater setups are a deliberate husbandry choice, not an accident.
- Main sources: Driftwood and bogwood are the most common in home tanks. Indian almond leaves, alder cones, oak leaves, and peat moss also contribute significantly.
- To reduce tannins: Pre-soak or boil wood before adding it, run activated carbon in your filter, and keep up with regular water changes.
- Blackwater tanks: These use tannins on purpose to replicate Amazon, Southeast Asian, and West African river habitats - and the fish from those regions genuinely do better in them.
What tannins actually are
The word "tannins" gets used loosely in the hobby. Technically, aquarium tannins are a mix of humic acids, fulvic acids, and tannin compounds proper - all released as organic matter breaks down in water. When wood decays in a forest stream, when leaves fall into a river, when peat accumulates in a swamp, these compounds dissolve into the water and give it that characteristic tea-brown colour. Your tank does exactly the same thing on a smaller scale.
The colour itself comes from humic substances - large organic molecules that absorb certain wavelengths of light. That's why blackwater looks brown rather than cloudy: it's chemically stained, not particulate-dirty. The water can be crystal clear in terms of suspended particles yet still look like cold brew coffee. First-timers often confuse this with a water quality problem. It isn't.
Pet shops rarely explain tannins well. Staff sometimes tell new fishkeepers to fix tinted water immediately, which sends people chasing a problem that doesn't exist. If your fish are active, eating, and your water parameters are in range, brown water from a piece of driftwood is not an emergency.
Where tannins come from in your tank
Driftwood and bogwood
The single most common source. New wood - especially softer pieces like Malaysian driftwood, mopani, or cholla - can leach heavily for weeks after you add it. The release slows over time as the soluble compounds are exhausted, but some wood keeps tinting water at a low level indefinitely. Harder, denser wood like spider wood typically releases less than softer pieces.
Indian almond leaves (Terminalia catappa)
These are added deliberately in betta tanks, shrimp tanks, and blackwater setups. As the leaves break down, they release tannins steadily over two to four weeks. One large leaf per 20 litres (5 US gallons) is a common starting point, though there's no hard rule. You can add more for a deeper tint or remove spent leaves before they fully disintegrate if you want to control the pace.
Peat moss
Used either as a substrate component or stuffed into a filter chamber, peat both releases tannins and actively softens water through cation exchange - it pulls calcium and magnesium ions out and releases hydrogen ions in return, which drops both hardness and pH. This makes it a powerful tool for breeding soft-water species, but it needs monitoring. pH can shift more than you expect if you add a lot.
Other botanicals
Alder cones, oak leaves, banana leaves, seed pods, and cork bark all contribute tannins. The hobby has embraced botanicals heavily over the last decade, and most of what's sold through specialist retailers is safe. The main variable is how much and how fast they break down - smaller, thinner botanicals release tannins quickly; larger woody pieces do it slowly.
Boiling botanicals before adding them to your tank removes surface contaminants, partially saturates them so they sink more readily, and gives you a rough sense of how much colour they'll release. The water in your pan after boiling is essentially a concentrated preview of what your tank will look like.
What tannins actually do to your water
This is where it gets more interesting than most guides suggest. Tannins don't just colour the water - they chemically interact with it.
pH: Humic acids are weak acids. They lower pH gradually, and the effect compounds over time as organic matter accumulates. In a well-buffered tank with moderate KH (carbonate hardness), the shift is minor - you might see 0.2-0.3 pH units of change from a single piece of wood. In a low-KH, soft-water setup, the same wood could push pH down by a full unit or more. This matters a lot for fish sensitive to pH swings.
Hardness: Tannins themselves don't soften water - that's the humic acids doing cation exchange. But in practice, the two effects often come together, particularly with peat. Softer, more acidic water is genuinely preferred by many species: cardinal tetras (Paracheirodon axelrodi), discus (Symphysodon spp.), wild-caught bettas, most South American dwarf cichlids, and the majority of small Southeast Asian rasboras.
Antibacterial effect: Tannins have documented antimicrobial properties. This is partly why wild blackwater rivers in the Amazon basin - despite being warm, low-oxygen, and apparently inhospitable - support such dense fish populations. In aquaria, the evidence for tannins preventing disease is real but modest. They're not a substitute for good hygiene and proper tank cycling, but they do contribute to a slightly hostile environment for certain pathogens.
Light diffusion: Tanned water scatters and absorbs light differently. For fish from forest streams and shaded jungle rivers, bright white light can be genuinely stressful. The amber tint acts like a natural light filter, and many shy or skittish species visibly relax in tinted water.
The Rio Negro in Brazil - one of the world's most famous blackwater rivers - runs at pH 4-5 with near-zero hardness. Most tank setups aim for pH 5.5-6.8 to balance authenticity with stability.
Blackwater tanks: intentional, not accidental
A blackwater setup isn't a tank where something went wrong - it's a deliberate habitat recreation. The goal is to mimic the chemistry and visual character of rivers like the Rio Negro (Amazon basin), the peat swamp streams of Borneo and Sumatra, or the coastal rivers of West Africa where killifish live.
In practice, this means letting wood, leaves, and botanicals accumulate, keeping hardness low (ideally under 5 dKH / 89 ppm), maintaining pH between 5.5 and 6.8, and using subdued lighting. Substrate is usually fine sand or bare-bottom, since gravel traps botanical debris in ways that can spike ammonia if you're not careful.
Fish that genuinely benefit from blackwater conditions include: most wild-type bettas (Betta splendens and relatives), cardinal and neon tetras, ram cichlids (Mikrogeophagus ramirezi), apistogrammas, chocolate gouramis (Sphaerichthys osphromenoides), and most Boraras species. These fish can survive in neutral, harder water - but they breed more readily, show better colour, and live longer in the conditions they evolved for.
Adding lots of botanicals to a tank that hasn't been properly cycled. Decomposing organic matter produces ammonia. If your biological filtration isn't established, a heavily botanical setup will spike ammonia fast. Always complete the nitrogen cycle first, then add botanicals gradually.
When tannins cause actual problems
Tannins themselves don't cause problems. But the conditions that come with heavy tannin sources sometimes do.
pH instability: If you're adding a lot of tannin-releasing material to a low-KH tank, pH can drift downward more than you anticipate. This is only dangerous if it happens quickly - a slow, stable drop to pH 6.0 is fine for most soft-water fish; a crash from 7.2 to 5.8 overnight is not. Test your pH and KH regularly when you first introduce significant wood or botanicals.
Ammonia from decomposing botanicals: Leaves and softer botanicals break down completely over weeks. As they do, they release organic compounds that your filter bacteria process - and briefly, in a tank that's already at its biological limit, this can nudge ammonia upward. Don't overload a new tank with botanicals all at once.
Oxygen levels: Heavy organic loads can reduce dissolved oxygen, particularly in warm water with low surface agitation. Blackwater tanks should have moderate surface movement - enough to oxygenate without destroying the tinted aesthetic.
Photosynthesis: Dense tannin staining does reduce light penetration, which affects plant growth. Stem plants and high-light species struggle in genuinely dark blackwater. Low-light plants - java fern (Microsorum pteropus), anubias, cryptocorynes - do fine.
Don't rely on tannins to buffer your pH against swings. They add mild acidity but provide almost no KH buffering capacity. If your carbonate hardness is very low (under 2 dKH), your pH can crash unpredictably regardless of tannins. Understand your tank's buffering before you target an acidic setup - read up on aquarium water parameters first.
How to reduce tannins if you don't want them
Some fishkeepers want the wood but not the colour. That's completely achievable - it just takes patience.
Pre-soak your wood. Before the wood ever enters your tank, submerge it in a bucket of water for one to four weeks, changing the water every few days. A lot of the initial tannin dump happens during this period. Boiling speeds it up significantly - 30-60 minutes of boiling plus a soak works well for most pieces.
Activated carbon in your filter. Carbon adsorbs humic and tannin compounds efficiently. A fresh bag of activated carbon will clear a lightly tinted tank within 24-48 hours. The catch: carbon becomes saturated and stops working after two to four weeks, at which point it starts releasing what it's absorbed. Replace it on schedule or remove it once the water clears.
Water changes. The simplest approach. Regular partial water changes dilute tannins gradually - see how often to do water changes for guidance on frequency. For a heavily tinted new tank, large changes (30-40%) every few days will speed up clearance significantly.
Wait. Most wood stops leaching heavily after two to three months. If you're patient and the tint doesn't bother your fish, doing nothing is also a valid option.
If you're running carbon to clear tannins, remove it once the water is clear rather than leaving it running indefinitely. Fresh carbon works; exhausted carbon sitting in flow doesn't - and it frees up filter space for biological media that actually contributes to long-term water quality.
Species to consider for a blackwater setup
If you're thinking about building a deliberate blackwater tank, the stocking options are genuinely beautiful. Small schooling fish look spectacular against dark, tinted water with leaf litter. Cardinal tetras, ember tetras (Hyphessobrycon amandae), and celestial pearl danios (Danio margaritatus) are excellent starting points - use the free stocking calculator to check numbers before you buy. Dwarf cichlids like apistogrammas and rams add personality and breeding interest. Corydoras and pygmy corys (Corydoras pygmaeus) work well as bottom-dwellers in soft-water setups. For a Southeast Asian theme, Boraras brigittae (chili rasboras) in a heavy botanical nano tank is one of the most visually striking setups you can build at low cost.
Track your parameters and get care reminders with App-aquatic.
Get the free appIs brown water from driftwood safe for fish?
Yes. Tannins are non-toxic, and many fish come from naturally tannin-stained rivers. Brown water from wood or leaves is not a water quality problem - test your actual parameters (ammonia, nitrite, pH) rather than judging by colour alone.
How long does driftwood leach tannins?
It varies by wood type and size, but most pieces leach heavily for the first four to twelve weeks, then slow considerably. Some wood produces a faint tint indefinitely. Pre-soaking before adding to your tank significantly reduces the initial surge.
Do tannins lower pH, and is that a problem?
They can, mildly. In a tank with normal carbonate hardness (KH above 4 dKH), the pH shift from wood or leaves is usually small - 0.2 to 0.5 units. In a soft, low-KH tank the effect is larger. Monitor pH when you first add tannin sources, and test KH so you understand your tank's buffering capacity.
Can I use Indian almond leaves with shrimp?
Yes - shrimp actually benefit from them. Neocaridina and Caridina shrimp both tolerate tannins well, and the mild antibacterial properties may help with shrimplet survival. Indian almond leaves also provide surface area for biofilm, which shrimp graze constantly.
Will activated carbon remove tannins permanently?
No. Carbon removes tannins while it's active (roughly two to four weeks before saturation), but it doesn't stop the wood or leaves from producing them. Once you remove
More guides · Wood and tannins · Water parameters · Betta care