
Large-spotted Yunnan loach
Yunnanilus macrositanus

The Large-spotted Yunnan loach features a slender body with prominent dark spots and a distinctive, elongated dorsal fin.
This page includes AI-generated images. Why am I seeing AI images?
About the Large-spotted Yunnan loach
Yunnanilus macrositanus is a little Chinese stone loach from the Heilongtan (Black Dragon Pool) area in Yunnan. Its wild biology is barely documented in the hobby, so I would treat it like a small, cool-water to mid-temp Nemacheilid: lots of oxygen, hiding spots, and a peaceful setup where it can poke around the bottom without getting bullied.
Also known as
Quick Facts
Size
7.2 cm
Temperament
Peaceful
Difficulty
Advanced
Min Tank Size
20 gallons
Lifespan
5-8 years
Origin
China (Yunnan Province)
Diet
Omnivore/micropredator - small sinking foods, micro pellets, frozen foods (bloodworms, daphnia, brine shrimp), and biofilm
Water Parameters
20-24°C
6.5-8
3-15 dGH
Need a heater for this species?
This species needs 20-24°C in a 20 gallon tank. Use our heater calculator to find the right wattage.
Calculate heater sizeCare Notes
- Give them a long tank with a strong river-style flow (powerhead or high turnover) and tons of oxygen - they act miserable in still, warm water.
- Keep it cool: aim roughly 60-72F (16-22C) with stable pH around 6.5-7.5, and keep nitrates low or they get ragged fins and stop showing themselves.
- Sand or smooth fine gravel only, plus rounded rocks and tight crevices - they wedge into gaps and will shred barbels on sharp substrate.
- Feed like a micro-predator, not a algae-eater: frozen bloodworms, blackworms, daphnia, chopped brine, and a small sinking carnivore pellet; do a couple small feedings and watch they actually get their share.
- They do best in a group (6+) so the shy ones come out, but expect a pecking order - scatter shelters so the boss fish can't claim the whole tank.
- Tankmates: stick with other coolwater, current-loving fish that aren't jerks (danios, hillstream-type loaches); skip slow fancy fish and anything that wants warm, calm water.
- Breeding is rare in community tanks, but a cool-water seasonal swing helps - heavy feeding plus a cooler period then a gradual warm-up and big water changes can trigger chasing; give dense moss or fine plants for eggs to disappear into.
- Watch for two classic screw-ups: low oxygen/high temp (they gasp and hug the filter outlet) and skinny bellies from being outcompeted at feeding time - target feed with a baster if you have faster tankmates.
Compatibility
Good Tankmates
- Small, calm rasboras (chili rasbora, harlequin rasbora) - they hang midwater, dont bother the loach, and everyone likes the same cool, clean water vibe
- White cloud mountain minnows - super chill schooling fish, fast enough to not get stressed, and they match the temps these Yunnan loaches do best in
- Danios (zebra danio, pearl danio) - active but usually not mean, and they keep to the upper levels while the loach cruises the bottom and plants
- Hillstream-type buddies (Sewellia and similar) - peaceful, love flow and oxygen, and they basically just do their own algae-grazing thing
- Small peaceful Corydoras (pygmy, habrosus) - both are polite bottom fish as long as youve got enough floor space, hides, and you feed sinking foods so nobody gets outcompeted
- Amano shrimp and nerite snails - these loaches are more nosey than murderous, and in a planted tank with hiding spots they usually ignore bigger shrimp and snails
Avoid
- Big aggressive stuff (cichlids like convicts, most medium-large barbs) - the loach is peaceful and will just get bullied off food and stressed out
- Fin-nippers (tiger barbs, some serpae-type tetras) - they make life miserable for everyone, and the loach will spend all day hiding
- Super warm-water fish (discus, most fancy guppies in heated setups) - wrong temps long-term, and the loach just never looks as good or as active
- Big predatory bottom fish (large dojo loaches, bichirs, big catfish) - even if they dont start mean, eventually somebody decides the little loach looks like a snack
Where they come from
Large-spotted Yunnan loaches (Yunnanilus macrositanus) come out of Yunnan, China. Think cool, clean hill streams and spring-fed waterways with lots of rock, gravel, and leaf litter - not warm, weedy ponds. That background explains almost everything about why they can be a bit touchy in typical community-tank setups.
If you try to keep them like a warmwater "bottom cleaner" in a tropical community tank, they usually fade over time. They do way better in cooler, high-oxygen setups.
Setting up their tank
These are advanced mostly because they are unforgiving about stale water and low oxygen. Give them a tank that behaves like a stream: steady flow, lots of surface agitation, and stable, clean water.
- Tank size: I would start at 20 gallons long for a small group. Bigger is easier to keep stable.
- Substrate: smooth sand or fine gravel. They spend a lot of time on the bottom and around stones.
- Hardscape: rounded river rocks, cobbles, and a few pieces of wood. Make little current breaks and crevices.
- Plants: optional. If you use them, pick stuff that handles cooler water (Anubias, Java fern, mosses).
- Filtration and flow: strong filtration plus a powerhead or spray bar. You want visible surface movement.
- Oxygen: high. Airstone is not mandatory if flow is good, but it never hurt me with this kind of fish.
For water, aim for cool-to-moderate temps and avoid big swings. They generally handle neutral-ish water fine if its clean, but they react fast to ammonia/nitrite and they do not love being cooked in the high 70s F for long.
Build in "boring" maintenance. Weekly water changes, pre-filter sponges you rinse often, and no letting mulm pile up under rocks. These loaches show you right away when you get lazy.
What to feed them
They are micropredators and pickers. Mine spent the day grazing biofilm and hunting tiny stuff between pebbles, and then got more active at feeding time. You will get better results feeding smaller foods more often instead of one big dump.
- Staples: sinking micro pellets, crushed high-quality pellets, and small wafers that soften fast
- Frozen: bloodworms (sparingly), daphnia, cyclops, brine shrimp, chopped blackworms if you can get them
- Live: baby brine shrimp, grindal worms, live daphnia - they go nuts for these
- Grazing foods: repashy-style gel foods work well because they can rasp at it
Do not assume they will compete at the surface. If you keep fast midwater fish, make sure food actually reaches the bottom and that the loaches get their share.
How they behave and who they get along with
They are more "busy" than aggressive. Expect lots of prowling, short dashes, and little standoffs over favorite cracks between stones. In a group they look more confident, and you see more natural behavior.
- Keep in a group if you can. I like 6+ if the tank size allows.
- Best tankmates: other cool-water, current-loving fish that are not bullies (small danios, white clouds, some hillstream loaches).
- Avoid: big, pushy bottom fish (large botias, large corys in tight tanks), nippy barbs, and anything that needs warm water.
- Shrimp/snails: small shrimp may get hunted, especially babies. Snails are usually fine.
Give them multiple "prime" hiding spots. If there is only one good cave, one loach often claims it and everybody else looks stressed.
Breeding tips
Breeding Yunnanilus is possible, but its not like livebearers where it just happens. Most success stories look like this: a settled group, heavy feeding on small live/frozen foods, and then a seasonal trigger (cooler water and big water changes) that mimics spring conditions.
- Start with a group and let them pair off naturally - sexing is not always obvious.
- Use a mature tank with lots of micro-life and cover (moss, fine plants, pebble beds).
- Try a "spring" routine: slightly cooler period, then several larger water changes with fresh, cooler water and stronger flow.
- If you see spawning behavior, consider moving adults out after a day or two. They can snack on eggs and tiny fry.
If you do get fry, the first foods are usually tiny: infusoria, vinegar eels, microworms, then baby brine shrimp as they size up. A well-aged sponge filter helps a lot here.
Common problems to watch for
Most issues I have seen with these come down to warm, low-oxygen water, dirty bottoms, or being outcompeted for food. They can look "fine" for weeks and then start losing weight or clamping fins.
- Skinny loaches: often not getting enough food in a busy community tank. Feed after lights out or target feed with a pipette.
- Hanging near the surface or rapid breathing: not enough oxygen or too warm. Add flow, increase surface agitation, and check temperature.
- Hiding all the time: not enough cover, too much light, or tankmates stressing them out.
- Bloat after heavy feeding: ease off rich foods (like lots of bloodworms) and rotate in daphnia and smaller meals.
They do not handle spikes. If you see odd behavior, test ammonia and nitrite right then, not tomorrow. With stream fish, problems can snowball fast.
Quarantine matters with these. Wild or farmed imports can bring in parasites, and loaches can be more sensitive to some medications. I go slow with dosing, use extra aeration, and I avoid mixing multiple meds unless I am 100% sure what I am treating.
Similar Species
Other freshwater peaceful species you might be interested in.

Ajuricaba tetra
Jupiaba ajuricaba
Jupiaba ajuricaba is a South American freshwater characin from the Amazon basin in Brazil (rio Negro, rio Solimões, and rio Tapajós basins). It reaches about 9.5 cm SL and is diagnosed by a narrow dark midlateral stripe, an elongated humeral spot, and an ocellated spot on the upper caudal-fin lobe. Wild specimens have been collected from blackwater forest streams and also oxbow-lake habitats.

Allen's river garfish
Zenarchopterus alleni
A poorly known freshwater halfbeak endemic to West Papua (Mamberamo River), described from a single specimen (~13 cm SL). Beyond basic habitat/occurrence, little is published about its ecology or aquarium suitability; assume it is a surface-oriented, jump-prone halfbeak only by analogy with related taxa.

Amapa tetra
Hyphessobrycon amapaensis
This is a tiny, super sleek little tetra with a clean red stripe down the side that really pops once its settled in. It does best in a planted, slightly tinted "creek-style" setup and looks way cooler when you keep a proper group so they school and flash that line together. If you can give it soft, slightly acidic water and a calm community, its an easy fish to fall for.

Amatlan chub
Yuriria amatlana
Yuriria amatlana (the Amatlan chub) is a little Mexican native minnow from the Ameca River basin. Its wild range is pretty limited and it is listed as Endangered, so its care info in the aquarium hobby is basically nonexistent and its availability is usually low. In the original species description, preserved fish show a dark lateral stripe with a darker patch on the caudal peduncle, and they can have tiny barbels at the mouth corners.

Andrica moenkhausia
Moenkhausia andrica
Moenkhausia andrica is a little Brazilian characin from the Tapajos system that tops out around 7 cm (about 2.8 inches) standard length. It has a neat netted (reticulated) scale pattern plus a dark spot on the caudal peduncle, and the really wild part is that mature females can have tiny fin hooklets too, which is usually a male-only thing in a lot of characins.

Anhanga pygmy pencil catfish
Potamoglanis anhanga
This is a truly tiny Amazonian trichomycterid catfish - like 1.3 cm max - so it is more of a micro-predator oddball than a typical community catfish. It is the kind of fish that disappears into sand, leaf litter, and plant roots, and you will spend way more time setting up the right micro-habitat than you will actually seeing it.
More to Explore
Discover more freshwater species.

American flagfish
Jordanella floridae
Jordanella floridae is that little Florida native with the red-and-cream striping that really does look like a tiny flag once a male colors up. They graze algae like champs (especially stringy/hair algae), but they have a bit of attitude - give them plants and space so the bossy behavior stays manageable. Bonus: the male guards the eggs and will actively fan them, which is pretty fun to watch.

Amur sculpin
Alpinocottus szanaga
This is a little coldwater sculpin from the Amur drainage - a bottom-hugging, rock-and-gravel fish that spends its day wedged under stones and darting out to grab food. Super cool behavior and attitude, but it is absolutely not a warm tropical community fish - it wants chilly, fast, oxygen-rich water and will bicker with other bottom fish.

Anitápolis livebearer
Jenynsia weitzmani
Jenynsia weitzmani is a freshwater anablepid livebearer endemic to southern Brazil (currently known only from the type locality near Anitápolis, Santa Catarina). Like other Jenynsia (onesided livebearers), reproduction involves lateralized mating morphology/behavior; aquarium care guidance is not well-documented for this species specifically.

Anteridorsal Homatula loach
Homatula anteridorsalis
This is a benthic Chinese stream loach from Yunnan that lives right down on the bottom in clear, flowing water over gravel and rocks. Think of it as a "river tank" fish - it wants current, oxygen, and lots of surfaces to poke around on for bits of food and algae.

Aracu-comum
Schizodon vittatus
Schizodon vittatus is a large South American anostomid (family Anostomidae). Reported maximum size is about 35 cm standard length; it is harvested/consumed in parts of Brazil and is not commonly covered by mainstream aquarium husbandry references.

Armoured stickleback
Indostomus paradoxus
This is that goofy little "freshwater seahorse"-looking fish that just kind of perches and scoots around like a tiny armored twig. Its whole vibe is slow, sneaky micropredator - once its settled in, you will catch it stalking microfoods and doing these subtle little posture displays. The big trick is feeding: they do best when you can provide lots of small live foods in a calm, planted tank.
Looking for other species?
