
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.

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.

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.

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.

Aroa twig catfish
Farlowella martini
Farlowella martini is one of those unreal-looking stick catfish that just vanishes the moment it parks itself on a branch. It is a super calm, slow-moving grazer that does best in a mature tank with lots of biofilm, gentle flow, and clean, oxygen-rich water - they are not great at competing at feeding time, so you kind of have to look out for them.

Austellus barb
Dawkinsia austellus
Dawkinsia austellus is a freshwater cyprinid endemic to southern India (Western Ghats region). It is an active, shoaling barb best maintained in a group in a spacious, well-filtered aquarium with good oxygenation and regular maintenance.
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.

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.

Arrowhead puffer
Pao suvattii
Pao suvattii is that sneaky Mekong puffer that likes to sit low and ambush food, and it has that super recognizable arrow/V pattern on its back. Gorgeous fish with tons of personality, but it is absolutely not a community guy - plan on a solo, species-only setup if you want everybody to stay in one piece.

Banded Leporinus
Leporinus fasciatus
Banded Leporinus are those torpedo-shaped, black-and-yellow striped fish that look like they're wearing a little prison outfit-and they stay on the move. They've got a ton of personality and they're awesome to watch cruising and picking at stuff, but they're also the kind of fish that will redecorate your tank and "taste test" anything soft-looking.

Bandi River dwarf cichlid
Wallaceochromis signatus
Wallaceochromis signatus is a rare little West African dwarf cichlid that used to show up in the hobby as Pelvicachromis sp. "Bandi 1" or "Guinea". It is a sand-sifter that loves to dig and claims a cave as its base, and the female usually has a really obvious black tail spot that makes ID pretty straightforward.

Bathybagrus platycephalus (claroteid catfish)
Bathybagrus platycephalus
This is a Lake Tanganyika claroteid catfish (Bathybagrus platycephalus; synonym Chrysichthys platycephalus) reported from deeper water (about 20-110 m) and associated with rocky substrate. It reaches ~22 cm TL and is a demersal predator, so small fish may be eaten if they fit in its mouth.
Looking for other species?
