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 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 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 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
AI-generated illustration of Aroa twig catfish
Freshwater
AI Generated
Photo

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.

MediumPeacefulAdvanced
Min. 30 gal
AI-generated illustration of Austellus barb
Freshwater
AI Generated
Photo

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.

MediumPeacefulIntermediate
Min. 55 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 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 Arrowhead puffer
Freshwater
AI Generated
Photo

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.

SmallAggressiveAdvanced
Min. 30 gal
AI-generated illustration of Banded Leporinus
Freshwater
AI Generated
Photo

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.

LargeSemi-aggressiveIntermediate
Min. 75 gal
AI-generated illustration of Bandi River dwarf cichlid
Freshwater
AI Generated
Photo

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.

SmallSemi-aggressiveIntermediate
Min. 30 gal
AI-generated illustration of Bathybagrus platycephalus (claroteid catfish)
Freshwater
AI Generated
Photo

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.

MediumSemi-aggressiveAdvanced
Min. 75 gal

Looking for other species?