Piscora
Aquatic water texture background

Large-spotted Yunnan loach

Yunnanilus macrositanus

AI-generated illustration of Large-spotted Yunnan loach
AI Generated
PhotoAll Rights Reserved

The Large-spotted Yunnan loach features a slender body with prominent dark spots and a distinctive, elongated dorsal fin.

Freshwater

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

Stone loachYunnanilus loachBig-spotted Yunnan loach

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

Temperature

20-24°C

pH

6.5-8

Hardness

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 size

Care 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.

AI-generated illustration of Ajuricaba tetra
Freshwater
AI Generated
Photo

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.

SmallPeacefulIntermediate
Min. 20 gal
AI-generated illustration of Allen's river garfish
Freshwater
AI Generated
Photo

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.

MediumPeacefulExpert
Min. 20 gal
AI-generated illustration of Amapa tetra
Freshwater
AI Generated
Photo

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.

NanoPeacefulIntermediate
Min. 20 gal
AI-generated illustration of Amatlan chub
Freshwater
AI Generated
Photo

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.

SmallPeacefulAdvanced
Min. 20 gal
AI-generated illustration of Andrica moenkhausia
Freshwater
AI Generated
Photo

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.

SmallPeacefulIntermediate
Min. 20 gal
AI-generated illustration of Anhanga pygmy pencil catfish
Freshwater
AI Generated
Photo

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.

NanoPeacefulExpert
Min. 5 gal

More to Explore

Discover more freshwater species.

AI-generated illustration of American flagfish
Freshwater
AI Generated
Photo

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.

SmallSemi-aggressiveIntermediate
Min. 20 gal
AI-generated illustration of Amur sculpin
Freshwater
AI Generated
Photo

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.

SmallSemi-aggressiveAdvanced
Min. 20 gal
AI-generated illustration of Anitápolis livebearer
Freshwater
AI Generated
Photo

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.

SmallSemi-aggressiveAdvanced
Min. 20 gal
AI-generated illustration of Anteridorsal Homatula loach
Freshwater
AI Generated
Photo

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.

SmallPeacefulAdvanced
Min. 40 gal
AI-generated illustration of Aracu-comum
Freshwater
AI Generated
Photo

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.

LargeSemi-aggressiveAdvanced
Min. 180 gal
AI-generated illustration of Armoured stickleback
Freshwater
AI Generated
Photo

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.

NanoPeacefulAdvanced
Min. 10 gal

Looking for other species?