You lean in to admire your newly trimmed carpet of Monte Carlo, and something moves. There they are: tiny white threads wriggling against the glass, dozens of them, all at once. Your stomach drops. Detritus worms are the surprise every planted tank owner eventually meets — and the first thing to know is that they are far less terrifying than they look. These millimeter-scale oligochaetes are harmless to your fish, your shrimp, and your plants. They are simply doing what they have always done: eating the waste nobody else wants.
What Detritus Worms Actually Are
Detritus worms are segmented annelid worms in the class Oligochaeta, the same broad group as earthworms. They measure just 1–5 millimeters, appear white or translucent, and live mainly in the substrate, tunneling through its upper layers to feed on fish waste, uneaten food, decaying plant matter, and mulm. In a healthy tank they stay out of sight — you typically only notice them when a water change flushes them into the water column, or when a population boom sends them waving from the glass.
They arrive the ordinary way: hitched onto new plants, carried in new substrate, or introduced with decor and filter media. Dense plantings help them settle in quietly, because thick roots and carpets trap the organic debris that feeds them — and the plant cover hides them entirely until something changes.
The key point that surprises most newcomers: detritus worms are a natural, permanent part of the aquarium ecosystem. They cannot be permanently eradicated, and they should not be. The goal is simply a tank where the population stays small enough that you rarely see them.
How to Identify Them (And Rule Out Lookalikes)
Before doing anything, confirm you are looking at detritus worms and not something more serious. Watch how they move:
- Shape: thin, thread-like, uniform width, like a tiny white hair or sewing thread.
- Movement: they wiggle — frantic, thrashing, S-shaped swimming through open water. They do not glide.
- Location: scattered through the water column after a disturbance, or clinging to the glass and waving in the current. Some burrow back into the substrate when conditions settle.
- Behavior: they ignore your livestock entirely. They do not crawl onto fish or congregate on shrimp.
This wiggle test matters because two other common "white worms" get confused with detritus worms, and one of them genuinely deserves a response. Here is how to tell them apart:
| Feature | Detritus Worms | Planaria | Rhabdocoela |
|---|---|---|---|
| Appearance | Thin white threads, 1–5 mm, uniform width | Flat, slimy body, arrow/triangular head with visible eyespots | Tiny white ovals, 1–3 mm, often roundish |
| Movement | Wiggles and thrashes through water | Glides smoothly across glass, head first | Glides or inches along surfaces |
| Danger level | Harmless to fish, shrimp, and plants | Can prey on shrimp fry, baby snails, and weak livestock; eggs are the real target | Harmless |
| Treatment | Reduce feeding and waste; no chemicals needed | Manual removal plus targeted treatment (see planaria guide) | Same as detritus worms — starve them out |
The decisive clue is the head: planaria have a distinctly triangular or arrow-shaped head with two dark eyespots. If you see that, you are not dealing with detritus worms — read our guide to planaria in planted tanks and how to remove them instead. If the worms are just featureless white threads, relax. You have detritus worms, and this article is your plan.
White worms can also accompany other common tank headaches. If your outbreak coincides with rotting roots, see rotting aquarium plant roots; if plants are melting at the same time, check plants dying after a water change.
What a Worm Bloom Is Really Telling You
A sudden bloom of detritus worms is not a crisis — it is a message. The worm population only explodes when its food supply explodes, so a tank suddenly full of white threads is reporting that something in your maintenance has drifted. Treat the worms as a dashboard light, not an emergency.
The usual causes, roughly in order of frequency:
- Overfeeding. The most common driver. Food that sinks uneaten into carpets or aquasoil is a worm feast, and planted tanks hide this waste from view.
- Infrequent substrate cleaning. Dense carpets and thick root zones accumulate mulm that a quick top-up water change never touches.
- Neglected filter maintenance. A clogged filter reduces turnover and oxygen, and the decaying gunk inside becomes worm nursery territory.
- Dead plant matter left to rot. A melted crypt leaf or decaying stem left in the back of a jungle tank feeds worms for weeks.
- New-tank cycling debris. Fresh aquasoil leaches organics early on, and temporary worm booms during cycling are common and self-correcting.
There is one exception to the "not a crisis" rule: if masses of worms are plastered on the glass above the waterline or waving from every surface, check your oxygen. Detritus worms live in the substrate, and low dissolved oxygen drives them upward, just as it drives fish to gasp at the top. In that case the worms are the least of your problems — increase surface agitation, clean the filter, and check for anything decomposing.
The Benefits Nobody Mentions
It helps to reframe these worms before reducing them, because they do genuinely useful unpaid labor in your tank:
- Waste processing. They consume waste and decaying organics that would otherwise fuel ammonia and feed green water algae blooms, converting debris into forms plants can use.
- Substrate aeration. Their burrowing moves water and oxygen through the top substrate layer, discouraging the anaerobic pockets that cause the rotten-egg smell in deep soil beds.
- Live food. To fish, a worm bloom is not a plague — it is a buffet. Many species hunt them enthusiastically, which is free enrichment and nutrition.
- Bioindicator. A small, stable population you almost never see means your tank's waste cycle is working. That is a success metric, not a failure.
None of this means you should cultivate them deliberately. It means the correct response to a bloom is maintenance, not extermination.
Step-by-Step: Reducing Detritus Worms Safely
Forget chemicals for now. The following plan starves the population back to invisibility over two to three weeks, and it is the only approach that works long-term because it addresses the food supply rather than the symptom.
- Feed less, starting today. Cut feeding to what fish consume completely in about two minutes, once or twice daily. Remove food still on the substrate after five minutes. For two weeks, err on the side of slightly hungry fish — they tolerate a lean period far better than chronic overfeeding.
- Vacuum the substrate 2–3 times per week. Work section by section with a gravel siphon, plunging gently into the top layer. Hover just above dense carpets rather than tearing through them. Each session doubles as a 20–30% water change.
- Clean the filter properly. Rinse mechanical media in old tank water (never tap water, which kills beneficial bacteria), clear the impeller and intake, and replace compacted filter floss. A canister full of decomposing debris is a worm factory.
- Remove dead and decaying plant matter. Trim melting leaves, pull dead stems, and clear mulm under hardscape and at the base of dense plants. If you are battling deficiency melt too, the plant nutrient deficiency guide helps you tell melt from starvation.
- Hold steady and repeat. The population will not vanish overnight — eggs already in the substrate will still hatch. Two to three weeks of disciplined maintenance collapses the population, and your normal weekly routine then keeps it invisible.
Do not expect a dramatic single-day transformation. What you should see is a gradual retreat: fewer worms on the glass after each water change, until one day you realize you have not noticed any in weeks. That is the victory condition.
Vacuums the organic bed the worm bloom is feeding on: Aqueon siphon vacuum.
Safe water for the cleanup water changes: Seachem Prime.
Fish That Eat Detritus Worms (And the Shrimp-Tank Caveat)
In a fish-only or community planted tank, adding natural predators is the most enjoyable form of worm control:
- Bettas — avid worm hunters; a single betta in a planted tank will patrol for them relentlessly.
- Corydoras — root through the substrate exactly where the worms live, combining cleanup with predation.
- Loaches — most loach species treat substrate worms as a primary food source.
- Angelfish and small cichlids — pick worms out of the water column and off leaves efficiently.
- Guppies, tetras, and other small insectivores — will all snack on worms flushed into the water column during maintenance.
The important caveat: predator fish only work in tanks that have fish. In a shrimp-only tank, bettas and loaches are not compatible housemates for obvious reasons. Shrimp tank owners should focus entirely on the feeding and vacuuming routine above, and accept a slightly slower decline. Cherry shrimp themselves ignore the worms, and the worms ignore the shrimp — the two can coexist indefinitely.
Snails complicate the picture slightly: if you are also fighting a snail problem, see snails eating aquarium plants, since the same overfeeding that feeds worms feeds pest snails.
The Shrimp-Tank Special Case: Identify Before You Treat
Shrimp keepers are the hobbyists most tempted to reach for chemicals, because a worm-covered glass wall feels catastrophic in a pristine nano scape. Slow down. The stakes of misidentification are highest here: detritus worms are harmless to shrimp, but planaria prey on shrimp fry and eggs, so the identification table above matters most in shrimp tanks.
For detritus worms in shrimp tanks, the plan is simply: feed less (shrimp need far less food than most owners give), siphon gently without disturbing shrimplets, and be patient. The population will contract.
What NOT to Do
Panic responses cost more livestock than detritus worms ever will. Avoid these:
- Do not tear down the tank. Ripping out substrate and restarting your cycle does not produce a worm-free tank — the worms recolonize within weeks, minus your established bacteria and plant growth.
- Do not overdose chemicals "just in case." Broad-spectrum dewormers and copper-based medications wipe out invertebrates, stress fish, and damage the biological filter. Copper is lethal to shrimp, and aquarium science sources are clear: for harmless detritus worms, treat the underlying cause rather than reaching for a bottle — as explained on the aquariumscience.org detritus worms guide. Chemicals are a last resort for confirmed planaria in fish tanks, not a first response to harmless worms.
- Do not treat blindly. The most common expensive mistake: seeing white worms, assuming the worst, and dosing before checking for eyespots. Five minutes with a magnifying glass and the comparison table above prevents it.
- Do not boil, bleach, or throw away your plants. Plants are a worm vector, not an infestation. A brief dip or quarantine handles new arrivals; destroying established growth punishes the wrong suspect.
- Do not stop feeding entirely. Starving your fish to spite the worms is cruelty with extra steps. Feed lightly and consistently.
Prevention: The Routine That Keeps Worms Invisible
Once the bloom is down, prevention is just good planted-tank husbandry. None of this is exotic:
- Weekly water changes of 25–30%, with the siphon worked into open substrate areas every time.
- Feeding discipline: the two-minute rule, every day. Consider a fasting day once a week — healthy fish handle it well.
- Monthly filter maintenance: rinse mechanical media in tank water, inspect the impeller, replace spent floss.
- Prompt plant cleanup: remove melting leaves and dead stems during the weekly trim rather than letting them decay. If plants are browning broadly rather than just aging out leaves, the plants turning brown guide will help you diagnose.
- Quarantine new arrivals: dip new plants and rinse new substrate before planting. You cannot keep every worm out, but you can avoid importing a starter colony.
- Stock cleanup-appropriate livestock for your setup: a small corydoras school or a betta in community tanks keeps the baseline population permanently trimmed.
Worms also share their risk profile with another classic planted-tank nuisance. If white worms on your glass make you want to understand every possible surface pest, the hydra removal guide covers the other tiny predator that shows up in well-fed tanks.
Frequently Asked Questions
Are detritus worms harmful to fish or shrimp?
No. Detritus worms are harmless scavengers that feed on decaying organic matter, not living tissue. They do not bite fish, do not parasitize livestock, and do not bother adult shrimp. They are a normal part of the aquarium ecosystem, comparable to the microfauna in garden soil.
Will detritus worms eat my aquarium plants?
No. Detritus worms eat dead organic matter — fish waste, uneaten food, and already-decaying plant material. They do not eat healthy living plants, and they do not damage roots. If plants are melting at the same time as a worm bloom, the worms are feeding on the decay, not causing it. Diagnose the plant problem separately.
Why do the worms come out after a water change?
Disturbing the substrate during siphoning flushes worms out of their burrows into the water column, where they are suddenly visible and thrash wildly. This is the most common way owners first notice them, and it usually means nothing alarming — it simply reveals a population that was living quietly in the substrate all along. Fewer worms appear after disturbances as your maintenance improves.
Can I get rid of detritus worms completely?
Realistically, no — and you should not try. They arrive on plants, substrate, and decor, and their eggs are nearly impossible to exclude entirely. Even a fully torn-down tank will be recolonized within weeks. The correct goal is population control through feeding discipline and substrate hygiene, which renders them effectively invisible in normal viewing.
Should I use deworming medication for detritus worms?
No. Medications like fenbendazole or copper-based treatments are overkill for a harmless animal, and they carry real risks: copper is lethal to shrimp and snails, and any broad treatment stresses fish and the biological filter. Reserve chemical treatment for confirmed planaria or hydra infestations. For detritus worms, the maintenance routine in this guide is safer and more effective long-term.
How do I know if my worms are planaria instead?
Look for three planaria markers: an arrow or triangle-shaped head, two dark eyespots, and smooth gliding movement across the glass. Detritus worms have none of these — they are featureless threads that wiggle and thrash. If you see the triangular head and eyespots, stop and read a planaria-specific guide before treating, since planaria can threaten shrimp fry while detritus worms cannot.
The Bottom Line
Detritus worms are not an infestation — they are feedback. A visible population is your tank politely informing you that too much food and debris are going uneaten, and the fix is the same husbandry that makes planted tanks thrive anyway: measured feeding, regular substrate vacuuming, and a clean filter. Follow the plan above for two to three weeks and the worms will recede into the substrate, back to their useful invisible jobs of processing waste and aerating your soil. Your plants, fish, and shrimp were never in danger — and your tank will be healthier for having listened to what the worms were telling you.