It schools tightly, stays peaceful with everything, ignores fins, and adapts to a wide range of water conditions without complaint. This guide covers the complete picture: tank setup, water parameters, diet, compatible tank mates, disease prevention, and the unique breeding behavior that sets this species apart from other nano schooling fish.
Harlequin Rasbora Origin: Southeast Asian Rivers and Blackwater Streams
Trigonostigma heteromorpha is native to the Malay Peninsula, Singapore, Sumatra, and southern Thailand. In the wild, it inhabits slow-moving, heavily vegetated streams and peat swamps where fallen leaves stain the water dark amber and the pH dips well below 6.0.
Remember it later
Planning to try this recipe soon? Save it for a quick find later!
Those blackwater environments are low in dissolved minerals, tannin-rich, and filtered by dense overhead vegetation. The harlequin rasbora evolved in water that many keepers would consider extreme.
In practice, this history works in the keeper's favor: the captive-bred fish sold today are far more adaptable than their wild ancestors, tolerating pH from 6.0 to 7.5 and moderate hardness without visible visible stress.
- Native range: Malaysia, Singapore, Sumatra, southern Thailand
- Wild habitat: Slow peat swamps and forest streams, heavily tannin-stained
- Wild water: Very soft, pH as low as 4.5-5.5 in natural peat areas
- Captive stock: Farm-raised fish dominate the hobby; adapted to broader parameters
- Close relatives: Lambchop rasbora (T. espei) and Hengel's rasbora (T. hengeli), both kept identically
Understanding the blackwater origin explains two practical points. First, harlequin rasboras genuinely prefer soft, acidic water even if they tolerate harder conditions.
Second, adding Indian almond leaves or driftwood to their tank is not decorative theater. It replicates conditions that keep their immune systems, coloration, and breeding behavior at full function.
Harlequin Rasbora Tank Setup: 10 Gallons for a School, More for a Community
A 10-gallon tank is the minimum for a school of eight harlequin rasboras kept alone. For any community tank with additional species, 20 gallons is the practical starting point.
Harlequin rasboras are active mid-water swimmers, and a school of ten needs enough horizontal space to move as a cohesive group rather than colliding at the glass.
A planted setup is the right choice for this species. Dense background vegetation gives individual fish a sense of refuge, which visibly tightens schooling behavior and reduces the low-level stress that comes from open, unstructured environments.
Java fern, Cryptocoryne wendtii, and Microsorum pteropus all thrive in the soft, slightly acidic water this species prefers.
Floating plants are a meaningful addition. Water sprite, frogbit, or salvinia diffuses surface light, creating the dappled, low-intensity illumination of their native forest canopy.
Harlequin rasboras kept under reduced surface light show stronger copper coloration and school more tightly than the same fish under a full-intensity LED pointed directly at the substrate.
Dark substrate makes the copper-orange body color and the black wedge visually striking. Fine black sand or dark gravel reflects less ambient light and produces a measurable difference in how the fish appear, particularly when a school of ten turns together in synchronized motion.
Current should be gentle. These are fish from slow peat swamps, not fast-moving rivers.
A sponge filter or a hang-on-back with a spray bar is preferable to a powerhead creating strong directional flow. Heavy current does not harm them outright, but they do not school naturally in turbulent water.
Water Parameters: Harlequin Rasboras Adapt Well, But Soft and Warm Is Best
The harlequin rasbora's adaptability to water parameters is one of its strongest practical advantages over more demanding soft-water species. Captive-bred stock tolerates pH from 6.0 to 7.5 and moderate general hardness without visible health problems.
That said, the fish display best and live longest in soft, warm, slightly acidic water. A tank maintained at pH 6.5, GH 4-8, and 78°F produces more vibrant coloration and more active schooling behavior than the same fish kept at the tolerance edges of 7.5 and 25 dGH.
| Parameter | Ideal Range | Tolerance Limit |
|---|---|---|
| Temperature | 76-80°F | 73-82°F |
| pH | 6.0-7.0 | 6.0-7.5 |
| Hardness (GH) | 2-10 dGH | 2-15 dGH |
| Ammonia | 0 ppm | 0 ppm |
| Nitrite | 0 ppm | 0 ppm |
| Nitrate | <15 ppm | <25 ppm |
Stability matters more than hitting exact numbers. A harlequin rasbora school at steady pH 7.2 will be healthier than the same fish bouncing between pH 6.5 and 7.0 due to inconsistent water change volume or irregular maintenance.
Test your parameters before and after water changes for at least the first month in a new tank to understand your system's drift pattern.
Harlequin Rasbora Diet: Omnivores That Accept Nearly Any Small Food
Harlequin rasboras are opportunistic omnivores. In their native streams, they pick off small insects, zooplankton, and plant matter from the water column throughout the day.
In captivity, they eat virtually anything offered and compete actively at feeding time despite their peaceful nature.
A high-quality micro pellet or small flake works well as the daily staple. Standard adult community flake is often too large for small rasboras.
Crush it between your fingers or choose a brand sized for nano fish specifically. Pellets that sink slowly are ideal, since harlequin rasboras feed primarily in the mid-water column rather than at the surface.
Supplement the staple diet two to three times per week with frozen or live food. Frozen daphnia and baby brine shrimp are the best regular supplements.
Daphnia in particular triggers intense schooling and foraging behavior, visibly improves coloration within a few days, and acts as a natural digestive aid. Live micro worms and baby brine shrimp are excellent for conditioning fish before a breeding attempt.
- Daily staple: Micro pellet or crushed small flake, high protein content
- Frozen supplement: Daphnia, baby brine shrimp, micro bloodworms (2-3 times per week)
- Live food: Baby brine shrimp, micro worms, daphnia for breeding conditioning
- Avoid: Large pellets that sink too fast, starchy kitchen foods, high-fat foods
- Frequency: Twice daily, two-minute portions maximum each session
Harlequin rasboras do not overeat in the same way some cichlids or goldfish do, but excess uneaten food is still a water quality problem. Keep portions disciplined, especially in soft-water tanks where the chemical buffer margin is smaller.
Harlequin Rasbora Schooling Behavior: Why You Need 8-10 Minimum
The harlequin rasbora is a tight schooling species. In the wild, schools of dozens to hundreds move together in synchronized response to light changes and perceived threats.
That behavioral drive does not disappear in a 20-gallon tank. It simply requires a large enough group to express properly.
A school of six produces adequate behavior. A school of eight to ten produces the synchronized turning, tight column formation, and continuous mid-water movement that makes this species one of the most visually compelling in the hobby.
The difference between six and ten fish in a well-planted tank is not subtle.
- Minimum school: 6 fish for adequate schooling behavior
- Recommended school: 8-10 for tight, synchronized display behavior
- Single fish or pair: Chronic stress, color loss, hiding, shortened lifespan
- Large schools (15+): The movement patterns become genuinely spectacular in a 30-gallon or larger planted tank
- Mixed groups: Harlequin rasboras school with lambchop and Hengel's rasboras naturally; a mixed group of all three is an advanced display option
School size also directly affects the copper-orange body color in all fish and the intensity of the black wedge pattern. Fish kept in groups below six tend to show duller coloration because they are in a state of low-level chronic stress.
Add fish to reach eight before concluding your rasboras have color problems.
Harlequin Rasbora Tank Mates: Compatible with Virtually Every Peaceful Community Fish
Harlequin rasboras are one of the easiest fish in the freshwater hobby to fit into a community tank. They do not nip fins, do not chase smaller fish, and hold their ground against mild pressure from other peaceful species without escalating.
The compatibility problem runs only in one direction: large or aggressive fish that treat rasboras as a food source.
- Neon tetras are the classic tetra comparison pairing. Both species prefer soft, warm water, occupy the same mid-level zone, and create a striking dual-school display when kept together in a planted tank.
- Corydoras catfish are an ideal bottom companion for a harlequin rasbora community. They occupy an entirely different zone, prefer soft water, and add substrate-level activity without competing with rasboras at feeding time.
- Cherry barbs make a similar sized mate that shares soft-water parameters and the same peaceful temperament. Male cherry barbs in breeding color alongside a school of harlequin rasboras is a genuinely striking display combination.
- Betta fish work well as a betta tank mate in a planted 10-gallon or larger tank. Harlequin rasboras do not nip betta fins, and bettas rarely fixate on a fast-moving school. This is one of the more reliable betta community combinations.
- Dwarf gouramis share soft-water preferences and a peaceful temperament. Keep one male gourami per tank; gourami-on-gourami aggression creates stress that spills into the whole community.
- Guppies prefer moderately hard water (pH 7.0-7.5, GH 10-20 dGH). A compromise near pH 7.0 and GH 8-10 allows coexistence in a peaceful community, but neither species is at its optimum. Monitor both groups for color and activity as indicators of water quality compromise.
- Zebra danios tolerate overlapping parameters but are considerably faster and more energetic. In a small tank, their speed can push harlequin rasboras toward the edges. A 20-gallon or larger tank reduces this effect.
- Tiger barbs are aggressive fin-nippers that harass slower, gentler fish. A school of tiger barbs will stress harlequin rasboras persistently, and the stress compounds over weeks into color loss and shortened lifespan.
- Angelfish (adult) will eat adult harlequin rasboras. Juvenile angels and rasboras coexist briefly, but once angels reach 3 inches body height, rasboras become prey. The timeline is predictable and the outcome is not reversible.
- Mollies need pH 7.5-8.2 and hard water for long-term health. Keeping mollies and harlequin rasboras at a compromise harms both species rather than benefiting either.
A 10-gallon planted tank with a school of eight harlequin rasboras and a pair of corydoras at the bottom is one of the most complete beginner community setups available. Both species share water parameters, occupy different zones, and require no special diet modifications.
For a planted 20-gallon with a single centerpiece fish, our pearl gourami care guide covers the species that pairs most reliably with harlequin rasboras in a community build.
Keepers who want a more advanced biotope setup should read our ram cichlid guide, which covers a species that shares soft-water preferences with harlequin rasboras and occupies the bottom zone without competing for mid-water space.
Harlequin Rasbora Breeding: Unique Egg Placement on Broad Leaf Undersides
Harlequin rasboras have a breeding behavior that sets them apart from nearly all other small schooling fish: they are substrate spawners that place eggs on the underside of broad leaves, not egg scatterers that broadcast into plants or over gravel. This is uncommon in fish of their size and makes deliberate breeding a more achievable goal than with many comparable species.
In a well-planted tank with broad-leaved plants like Cryptocoryne or Amazon sword, conditioning pairs will spawn without significant intervention. The male inverts alongside the female beneath a broad leaf and both release eggs and sperm simultaneously.
The eggs adhere to the leaf underside in small clusters. A single spawning session produces 80 to 100 eggs across multiple leaf sites.
To breed deliberately, set up a separate 5- to 10-gallon breeding tank with very soft, acidic water (pH 6.0-6.5, GH 1-4 dGH), a sponge filter on the lowest setting, and several broad-leaved plants. Cryptocoryne species and Amazon sword are the standard choices.
Dim lighting encourages spawning.
Condition a pair or small group on live or frozen daphnia and baby brine shrimp for one to two weeks before transferring them to the breeding tank. The female should be visibly rounder with eggs before transfer.
Males in condition develop a richer copper tone and begin pursuing females actively.
- Trigger: Condition on live food for 1-2 weeks, then transfer to soft acidic breeding tank
- Spawning site: Underside of broad leaves (Cryptocoryne, Amazon sword, broad Anubias)
- Egg count: 80-100 eggs per session across multiple leaf sites
- Hatch time: 24-36 hours at 78-80°F
- Free-swimming: Fry become free-swimming 3-5 days after hatching once yolk sac is absorbed
- First food: Infusoria or commercial liquid fry food for 5-7 days, then newly hatched baby brine shrimp
- Adult removal: Remove adults immediately after spawning. Both parents will eat eggs and fry without hesitation.
Fry are very small and require infusoria-level first foods for the first week. A well-established tank with green water or a separate infusoria culture provides enough microscopic food in the early days.
Baby brine shrimp become viable at about one week post-hatching.
Juveniles reach 1 cm at approximately six weeks and begin showing adult coloration including the black wedge at eight to ten weeks. The black wedge develops before the copper body color reaches full intensity, so juveniles pass through a phase where the patch is visible on a pale background before the orange deepens.
In a community tank without a dedicated breeding setup, egg and fry survival is near zero. Adults eat the eggs within hours of laying.
Dense broad-leaved plants give eggs a small chance in a species-only tank, but even there, expect most to be consumed before hatching without the parents removed immediately after spawning.
Common Diseases and Health in Harlequin Rasboras
Harlequin rasboras are among the hardiest small community fish available. Their disease resistance is frequently cited as a reason to recommend them to beginners, and that reputation is earned.
A school in stable, clean water with adequate nutrition rarely shows health problems outside the introduction period.
The introduction period is the highest-risk window. New fish stressed by transport and acclimation are susceptible to ich and velvet regardless of the destination tank's health.
A two-week quarantine before introducing any new fish to an established system protects the whole community.
- Ich: White salt-grain spots on fins and body. Raise temperature gradually to 82°F (within their tolerance) and treat with half-dose copper medication. Their small body mass makes them more sensitive than larger fish to full-dose copper treatment.
- Velvet: Fine gold or rust dust across the body surface. Spreads rapidly. Treat with medication specific to velvet and black out the tank for three days. Velvet's lifecycle requires light; blackout disrupts it.
- Fin rot: Frayed or receding fin edges. Almost always follows a water quality event (nitrate spike, pH crash). Test water first. Clean water resolves mild cases without medication. Antibiotic treatment is for cases that progress despite clean water.
- Neon tetra disease: Despite the name, affects rasboras as well. Symptoms include white or pale patches through the body that do not respond to ich treatment, progressive muscle wasting, and isolation from the school. There is no effective treatment; remove affected fish promptly.
- Internal parasites: Fish that isolate, stop eating, and waste despite clean water are frequently carrying internal parasites. Metronidazole-laced food treats most internal infections before they progress to fatal wasting.
Medication reduces dissolved oxygen and the increased surface agitation compensates.
The most reliable disease prevention for this species is stable water chemistry and a two-week quarantine for all new arrivals. Harlequin rasboras that have never experienced a significant nitrate spike or pH crash rarely get sick in an established planted tank.
Harlequin Rasbora Lifespan: 5-8 Years with Good Husbandry
Harlequin rasboras live 5 to 8 years in a well-maintained aquarium. That range is wider than most keepers expect for a fish that costs $3 at the fish store.
The difference between a five-year fish and an eight-year fish comes down to three variables: school size, water stability, and diet quality.
School size is the most underestimated factor in longevity for this species. A harlequin rasbora kept in a group of four is in chronic low-level stress from the time it is added to the tank.
That stress does not produce dramatic symptoms in the first few months. It shows up as slightly reduced color, slightly reduced activity, and then a lifespan that ends at four years instead of seven.
| Husbandry Factor | Minimum Care | Optimized Care |
|---|---|---|
| School size | 6 fish | 8-10+ fish |
| Water changes | 25% every 2 weeks | 25-30% weekly |
| Diet | Flake only | Flake + frozen daphnia and BBS 3x/week |
| Temperature stability | ±3°F variance acceptable | ±1°F variance |
| Nitrate ceiling | Under 25 ppm | Under 15 ppm |
| Expected lifespan | 4-5 years | 6-8 years |
Weekly 25-30% water changes matter more in soft, low-buffering-capacity tanks than in alkaline community setups. Soft water loses pH stability faster between changes.
A tank maintained at pH 6.5 with weekly changes will stay within 0.1 to 0.2 pH units of that target indefinitely. The same tank with biweekly changes often drops to pH 6.0 or below by day 12.
The unique breeding behavior on the underside of broad leaves gives motivated keepers a rewarding project without requiring specialized equipment. Keep a school of eight in a planted 10-gallon or larger tank, maintain nitrates below 15 ppm with weekly water changes, and supplement the staple diet with frozen daphnia a few times per week.
This is a fish that stays interesting for the full five to eight years it lives.