The school + tank-length combination
Harlequin rasboras are loose-shoaling mid-water fish — not as tightly schooled as zebra danios or rummy-nose tetras, but visibly cohesive when housed correctly. The textbook synchronized-wedge display, where eight or ten fish hold a loose diamond formation mid-tank with the black triangle markings aligned, is the payoff for keeping the species at all. Under-grouped harlequins skip the formation entirely and spend most of the day half-hidden in plants.
The mainstream consensus is six as a hard minimum and eight to ten for the reliable display. The other half of the equation is tank length: harlequins swim laterally as a school, not in tight circles, so a 20-gallon long (30 inches) is the realistic floor where the school can actually move. A standard 10-gallon (20 inches) cramps the same school of six and makes them look constantly twitchy — they hit the glass on every pass and turn back.
Tank size and footprint
A 20-gallon long (30 in × 12 in × 12 in) houses a school of six to eight harlequins with room to grow. A 29-gallon (30 in × 12 in × 18 in) is the same footprint with more vertical space — useful if the tank pairs harlequins with corydoras (bottom dwellers) or a dwarf gourami (top dweller), since each species ends up with its own horizontal stratum.
For a fuller display, a 40-breeder (36 in × 18 in × 16 in) supports twelve to fifteen harlequins comfortably and produces the most consistent wedge-formation behavior in the hobby photos you see. Taller tanks with smaller footprints (column tanks, tall hex tanks) do NOT suit the species — vertical space is wasted on a fish that stays in the middle band, and the lateral runway is what they actually use.
Water parameters
Harlequins evolved in shaded blackwater streams across Southeast Asia. Wild-caught stock is parameter-strict; modern commercial stock is tank-bred over many generations and adapts to the standard community-tank range:
- Temperature: 73–82°F (23–28°C). Pairs naturally with most community species in the same range.
- pH: 6.0–7.5. Slightly acidic is ideal; alkaline tap water (pH 8+) washes the color over weeks.
- GH: 2–12 dGH. Soft to moderately hard.
- Ammonia / nitrite: 0 ppm sustained.
- Nitrate:< 20 ppm with weekly water changes.
Harlequins tolerate parameter swings better than neons but worse than guppies — they don't die from a 0.5 pH swing, but they do fade and stop schooling for a week or two while they recover. Drip- acclimate over 30 minutes when introducing new fish from a store with different water.
Filtration, substrate, and lighting
The single biggest visual lever for harlequins is substrate. The species is bred to display the orange-red body and crisp black wedge against a dark, broken background — that's how it looks in its native habitat under fallen leaves and shaded canopy. Setup recipe:
- Filter: Standard HOB or sponge filter at the lower end of the 6–10× turnover band. Harlequins are not strong swimmers — blasting flow keeps them pinned to one corner. See the filter-flow calculator.
- Substrate:Dark sand or fine dark gravel. The color shift between a light-gravel tank and a black-sand tank with the same school is dramatic; it's the same fish.
- Plants: Live plants substantially improve confident mid-water behavior. Floating plants (Amazon frogbit, salvinia) cast dappled light that triggers full color expression. Java fern, Anubias, and Cryptocoryne are the workhorse mid-tank choices.
- Lighting: Moderate to dim. Bright bare-bottom tanks make harlequins look washed out and behaviorally cautious. Cap at 6–8 hours per day.
Tank mates
Genuinely community-safe with anything its own size or smaller — shrimp included, though fry will be picked at. The species occupies the middle band of the tank and rarely interacts with bottom or top dwellers. Good combinations:
- Corydoras catfish — bottom dwellers, same parameter range
- Otocinclus — small algae grazers, peaceful
- Neon, cardinal, ember tetras — keep each species at 6+
- Cherry barbs — same loose-shoaling pattern
- Dwarf gourami (one male only) — top-water territory holder
- Mystery / nerite snails — invertebrate clean-up crew
- Adult cherry shrimp — fry will be eaten
Avoid:
- Adult angelfish — size mismatch; harlequins fit the mouth
- Aggressive cichlids — territorial harassment
- Tiger barbs / serpae tetras — fin-nippers
- Anything significantly larger than the harlequin's body
Diet
Mid-water omnivores. Tank-bred harlequins take standard community-fish foods readily:
- High-quality flake or micro-pellet sized for small mouths (Tetra Color, Hikari Micro Pellets, Bug Bites Microgranules) as the staple.
- Frozen or freeze-dried supplements 2–3× per week: daphnia, cyclops, baby brine shrimp, finely-chopped bloodworms.
- Feed twice daily, only what the school finishes in 30 seconds. Uneaten food on a dark substrate is hard to spot and degrades water quality fast.
Common health issues
- Ich. White spots after a temperature drop or new-fish stress event. Raise temperature to 82°F for 10 days, medicate if persistent.
- Color fade. Not a disease — usually a husbandry signal. Audit school size, substrate color, lighting, and parameter range in that order before reaching for medication.
- Bacterial fin damage. Usually water quality. Test ammonia and nitrite, do a 30% water change, verify the cycle is stable before treating.
Where hobbyists disagree
- Lambchop vs harlequin rasbora. Two visually similar species are sold under overlapping common names — Trigonostigma heteromorpha (true harlequin, the iconic black wedge) and T. espei (lambchop or espei rasbora, a thinner curved marking). Husbandry is nearly identical; the lambchop is genuinely a different species, not a color form.
- School size floor.Some keepers run schools of 4–5 successfully long-term. It works in the sense that the fish don't die, but the schooling display is suppressed and you lose what makes the species worth keeping. The conservative beginner-safe answer remains 6+ minimum.
- Soft-water requirement. Wild-caught harlequins need soft acidic water. Modern tank-bred stock adapts to hard alkaline tap water but loses color. Whether to RO down is a cosmetic-vs-practical call.
Frequently asked questions
- How many harlequin rasbora do I actually need?
- Six is the common care minimum across mainstream references; eight to ten is where the iconic synchronized wedge-school behavior shows up more reliably. The wedge marking is also a visual signature — when half the school is out and half is hidden, the pattern visually breaks. A larger group keeps the school behavior continuous instead of intermittent.
- Why does a 20-gallon long matter for harlequins specifically?
- Harlequins are loose-shoaling mid-water fish that move across the long axis of the tank. A 10-gallon (20 in long) gives a school of 6 about 3 inches per fish of swim runway before they hit the glass — they spend most of their time turning, not swimming. A 20-long is 30 inches and produces visibly relaxed mid-water cruising in the same group size.
- Do harlequin rasboras and neon tetras school together?
- No. They cohabit peacefully and pick up some loose coordination, but they don't form a true mixed school — each species needs its own group of 6+ to express normal behavior. Keep both species at 6+ each. The shared blackwater-substrate aesthetic is real; the mixed-schooling rumor is not.
- Why are my harlequins pale?
- Three common causes, in order of likelihood. First, light substrate and bright lighting — harlequins evolved in shaded blackwater streams; they wash out in white-gravel tanks under reef-grade LEDs. Second, under-grouping — solo or 4-fish groups lose color from stress. Third, parameter drift (high pH from crushed coral, hard water, or aged tap). Confirm school size and substrate before assuming a parameter issue.
- What water parameters does this species need?
- Temperature 73–82°F (23–28°C), pH 6.0–7.5, GH 2–12 dGH per FishBase ranges. Tank-bred commercial stock — which is most of what's sold now — tolerates a wider range than wild fish, but parameters in the middle of the range produce the deepest color and most confident schooling. Soft, slightly acidic water and dark substrate are the visual unlock.
Related
- Tank volume calculator — verify your tank actually delivers the 30-inch lateral runway a school needs.
- Compatibility checker — confirm the rest of the community before adding the rasbora school.
- Cycling a new aquarium — non-negotiable before adding any fish.
- Schooling fish minimum group size — the wider behavior-math reference behind the 6-minimum floor.
- Best fish for a 20-gallon community tank — sourced stockings that include harlequins as an anchor school.
Not veterinary advice — for sick fish or tank emergencies, consult an aquatic veterinarian or a qualified local aquarium professional.
Primary sources. FishBase (Trigonostigma heteromorpha) — taxonomy, native range, maximum size, and published temperature / pH / hardness tolerances. Conservation status via the IUCN Red List entry lookup. Husbandry numbers on this page (specific tank-size minimum, group-size floor, nitrate ceiling, diet, tank-mate fit) are hobby-practice ranges synthesized from mainstream hobby references (Aquarium Co-Op, Tetra, Practical Fishkeeping, Seriously Fish) and are clearly labeled as hobby consensus where they extend beyond what the primary sources publish. Where sources diverge, this page picks the answer that fails safest for a beginner's first batch.