Koi Angelfish Care Guide: Tank Setup, Diet & Compatibility

Species Overview#

Koi angelfish (Pterophyllum scalare) are a selectively bred color morph of the common South American freshwater angelfish, named for their three-color orange, black, and white patterning that mimics the look of Japanese koi pond fish. They are not a separate species — every koi angelfish you see on a store shelf is the same Amazon basin cichlid that has been kept in the hobby for nearly a century, just bred for a specific gene combination that produces the koi pattern.

The strain has become one of the most commercially successful freshwater fish in the US trade because the pattern appeals visually to keepers who would never consider a wild-type silver angel. Their care requirements are identical to standard Pterophyllum scalare: tall tanks, soft slightly acidic water, calm flow, and a community of mid-to-large peaceful tank mates that will not nip their long, trailing fins.

Adult size

6 in body, 8 in with fins

Lifespan

10–12 years

Min tank

55 gallons (pair or community)

Water

Soft, acidic Amazon-style

Temperament

Semi-aggressive (spawning)

Difficulty

Intermediate

What Makes Koi Angelfish Different From Other Angelfish Strains#

The defining feature of a koi angelfish is the three-color marbling: an orange or red-orange "crown" patch on the head, irregular black blotches across the body, and a white or pearl-white base. Pattern intensity varies between individuals and even between siblings from the same spawn — no two koi angelfish look alike, which is part of their commercial appeal.

The orange pigmentation is genuine carotenoid expression, not artificial dyeing, and it usually deepens with a quality varied diet rich in color-enhancing foods like krill, daphnia, and high-quality marine-derived pellets. The black marbling is controlled by the marble gene (M), and the white background is the absence of melanin in those areas. Breeders have been selectively pairing koi-pattern fish since the 1990s to stabilize the look, but throwbacks to silver or full-marble fry are still common in any spawn.

Size & Lifespan#

Adult koi angelfish reach roughly 6 inches in body diameter and up to 8 inches in total height once their dorsal and anal fins are fully extended. They are classic disc-shaped cichlids — narrow front-to-back, very tall top-to-bottom. Properly cared-for specimens routinely live 10 to 12 years in home aquariums, with some reaching 15 years in optimal conditions.

The vertical body shape is the single most important physical fact about this fish. A short tank that suits a community of tetras will leave an adult angelfish constantly scraping its dorsal fin against the lid or stunting in growth.

Behavior & Personality#

In a community tank with appropriate mates and ample space, koi angelfish are calm, curious, and visually engaged with their keepers. They learn feeding routines fast and will swim to the front glass when they recognize the person who feeds them. They patrol the upper and middle water column and rarely venture to the substrate.

Aggression flips on during pair bonding and spawning. A bonded male and female will stake out a vertical surface — a broad plant leaf, a piece of slate, the heater, the filter intake — and defend a territory of one to two feet around it. Other angelfish are the most common targets, but even bottom dwellers crossing into the spawning zone will be chased.

Water Parameters & Tank Requirements#

Koi angelfish are Amazon basin fish, and they do best in water chemistry that reflects that origin: warm, soft, slightly acidic, and biologically stable. They tolerate harder, more neutral tap water in many US cities, but spawning success and long-term color development both improve in conditions closer to their native range.

Ideal Water Conditions#

Aim for 76–84°F, with 80°F a reasonable sweet spot for general keeping. pH should sit between 6.0 and 7.5, and general hardness between 3 and 8 dGH. Soft slightly acidic water is preferred, especially if you intend to breed them — eggs often fail to develop in hard alkaline water even if the parents otherwise look healthy.

Stability matters more than hitting the exact center of any range. A tank that holds steady at pH 7.6 and 76°F will produce healthier angels than one that swings between 6.4 and 7.4 every week chasing the "ideal" number.

Minimum Tank Size & Dimensions#

For a single pair of adult koi angelfish, 29 gallons in a tall configuration is the absolute minimum. For a community tank with one pair plus dither fish like rummy nose tetras and a small group of corydoras, 55 gallons is the realistic starting point. Tanks taller than 18 inches are strongly preferred to accommodate the full vertical fin spread of mature fish.

If you plan to keep a group of juveniles to let a pair form naturally, start in a 55- to 75-gallon tank — by the time the pair forms, you will need to either rehome the unpaired fish or have enough space for the bonded pair to defend territory without harassing the others to death. See our guide to aquarium dimensions for footprint and height comparisons.

Filtration & Flow#

Use a sponge filter, canister filter with the spray bar baffled to soften output, or a hang-on-back filter pointed at the back glass to break up the current. Koi angelfish are weak swimmers and will refuse to enter areas of strong, direct flow. Their fins also tear easily in turbulent water.

Filtration capacity should be sized generously — angelfish are mid-to-large cichlids that produce significant waste, and they are noticeably sensitive to ammonia spikes. Plan for 6–8x tank turnover per hour split between mechanical and biological capacity, with the bulk of flow biological. Test for ammonia and nitrite weekly during the first three months of any new tank, and any time the bioload changes.

Aquascape Considerations#

Tall plants are mandatory. Vallisneria species, Amazon sword (Echinodorus spp.), and Cryptocoryne spear-leaf species all give angelfish vertical structure to break up sightlines and provide spawning surfaces. Driftwood pieces angled to create vertical territory anchors mimic submerged tree roots in the wild and reduce intra-species aggression by giving each angel a defensible "corner."

Avoid sharp rockwork and any decoration with cutting edges — angelfish trailing fins shred on rough surfaces, and the resulting wounds invite bacterial infection. Substrate is a personal call; fine sand or smooth rounded gravel both work, with sand giving a more natural Amazon look.

Diet & Feeding#

Koi angelfish are opportunistic carnivores in the wild, eating insect larvae, small crustaceans, and the occasional small fish. In captivity they accept a wide range of prepared and frozen foods enthusiastically, which makes them straightforward to feed. The bigger risk is overfeeding — angelfish will keep eating long past satiation if food is offered.

Staple Foods & Feeding Schedule#

Feed a high-quality cichlid flake or small pellet 2–3 times daily, with each feeding sized so it is consumed within 60–90 seconds. Supplement two or three times per week with frozen bloodworms, frozen brine shrimp, or frozen mysis shrimp. Spirulina-based foods rotated in once a week support color and digestive health.

Color-enhancing foods with natural carotenoids — krill meal, astaxanthin-rich pellets, daphnia — meaningfully deepen the orange crown over weeks of consistent feeding. Generic flake-only diets produce washed-out koi angels over time.

Foods to Avoid#

Skip live feeder fish entirely. Feeders sourced from commercial suppliers carry high parasite and disease loads, and the protein and fat profile of goldfish in particular is poorly suited to angelfish digestion. Avoid mammal-based foods (beef heart in heavy rotation is an old practice that causes long-term liver issues — occasional use is fine, daily feeding is not).

Tubifex worms from sketchy sources are another classic angelfish disease vector — only use frozen or freeze-dried tubifex from reputable brands, never live tubifex of unknown origin.

Tank Mates & Compatibility#

A peaceful community is achievable with the right selection, but two failure modes come up repeatedly: fin nippers, and prey-sized nano fish.

Best Community Companions#

Corydoras catfish (any common species — bronze, panda, sterbai), rummy nose tetras, larger rasboras like harlequin or scissortail, dwarf gouramis (one male only), and bristlenose plecos all coexist well with koi angelfish in tanks of 55 gallons or more. The shared preference for soft, warm, slightly acidic water makes most South American and Southeast Asian community species good chemistry matches as well.

For more options across this profile see the freshwater fish guide, which covers species selection by tank size and difficulty.

Species to Avoid#

Tiger barbs, serpae tetras, and any other notorious fin nippers will systematically destroy angelfish fins over weeks. Very small nano fish — neon tetras, ember tetras, chili rasboras — are size-appropriate prey for an adult angelfish and will eventually be picked off one by one. Aggressive cichlids like convicts, jewel cichlids, or any large central American species will outcompete and bully angels in shared space.

Keeping Multiple Angelfish#

Two adult angels of opposite sex tend to either bond into a pair or fight relentlessly, with little middle ground. The reliable strategy is to buy 6 or more juveniles together and let pairs form naturally as they mature — when a pair locks in, rehome the rest or move them to a separate tank.

Odd-numbered groups (5, 7) reduce aggression in dither-style schools more effectively than pairs or even numbers, because no single fish becomes the sole target of the dominant individual.

Breeding Koi Angelfish#

Koi angelfish are one of the easier freshwater cichlids to spawn at home, and the visual appeal of the strain makes them genuinely worth breeding for hobbyists with the space to raise fry.

Sexing & Pair Bonding#

Adult koi angelfish are notoriously difficult to sex visually outside of spawning. Males have a slightly more pronounced forehead bump (nuchal hump) and a thinner, pointed breeding tube; females have a wider, blunter ovipositor. Both differences are subtle and only reliably visible in the days before spawning.

The dependable approach is to buy 6–8 juveniles, raise them together, and let pairs bond on their own timeline — usually between 8 and 14 months of age in well-fed groups.

Spawning Conditions & Egg Care#

Provide a vertical spawning surface: a piece of slate angled at 60–80 degrees, a broad Amazon sword leaf, or a length of PVC pipe attached vertically to the back glass. Raise temperature to 82–84°F, perform a slightly cooler 25% water change to simulate a rainy-season trigger, and feed heavily on frozen bloodworms and brine shrimp for two weeks beforehand.

The female lays 200–800 eggs in vertical rows; the male follows immediately to fertilize. Both parents will fan the eggs, pick off infertile (white) ones, and guard the clutch. First-time pairs almost always eat their first 2–4 spawns — this is normal and not a failure of the parents.

Raising Fry#

Eggs hatch in 48–60 hours and the wrigglers attach to the spawning surface. They become free-swimming around day 5, at which point they need food. Start with microworms or vinegar eels for the first 3–4 days, then transition to newly hatched baby brine shrimp once they grow large enough to take them.

Daily 25% water changes with temperature-matched water are critical during fry growout. Aim to move fry to a separate growout tank by 4–6 weeks if you intend to raise the entire spawn — adult parents will eventually start consuming fry as the next spawn approaches.

Common Health Issues#

Koi angelfish are reasonably hardy when water quality is stable, but a handful of conditions show up often enough that every keeper should recognize the early signs.

Ich & Velvet#

White-spot disease (Ichthyophthirius multifiliis) and velvet (Piscinoodinium pillulare) are both protozoan parasites that thrive when fish are stressed by shipping, sudden temperature drops, or poor water quality. Ich presents as discrete white spots; velvet looks like a fine gold or rust-colored dust over the body.

Treat both by raising temperature gradually to 86°F over 24 hours and using a copper-free angelfish-safe medication (rid-ich plus, ich-x, paragon are common choices). Angelfish are scaleless-like in their sensitivity to harsh medication — dose at half strength initially and watch for stress response. Always remove activated carbon before treating.

Hole-in-the-Head Disease#

Hole-in-the-head (HITH), caused or worsened by the protozoan Hexamita in combination with poor water quality and nutritional deficiencies (especially vitamin C and HUFAs), shows up as small pits on the head and along the lateral line. Early lesions look like sandpapered patches; advanced cases develop into deep cavities.

Treatment combines aggressive water quality improvement (large frequent water changes, drop nitrate below 10 ppm), high-quality varied diet with vitamin supplementation, and metronidazole dosed in food at 50 mg per kg of fish daily for 7–10 days.

Fin Rot & Bacterial Infections#

Frayed fin edges that progress into receding fin tissue indicate bacterial fin rot, almost always triggered by poor water quality, fin damage from nipping, or stress. Catch it early and clean water alone — daily 25% water changes for a week — often resolves the problem without medication.

For advanced cases or systemic bacterial infections, treat with kanamycin or a furan-based antibiotic in a quarantine tank. Never dose antibiotics in a planted display tank — they wreck the biofilter and kill plants.

Where to Buy & What to Look For#

The koi angelfish you bring home is going to live a decade if cared for properly, so the 10 minutes you spend inspecting the fish at the store is the highest-leverage time investment in the entire purchase.

Evaluating Koi Angelfish at Your Local Fish Store#

Look for fish with vivid color saturation (the orange should be deep, the white clean, the black sharply defined), erect fully-extended dorsal and anal fins, active swimming behavior, and clear bright eyes. Pass on fish with clamped fins, white spots, fuzzy patches, ragged or split fins, or any sign of "shimmying" (rapid in-place fin twitching that signals neurological or osmotic stress).

Ask the store staff to feed the tank while you watch. A healthy koi angelfish should respond to food immediately and eat aggressively. Fish that ignore food, mouth and spit it out, or hang back from the feeding action are stressed, sick, or both.

Price Range & What Drives Cost#

Standard captive-bred koi angelfish at a typical local fish store run $8–$25 for juvenile to subadult sizes. Premium grades — well-defined pattern, deep saturated orange crown, larger size, named breeder lineage, or veil-tail variants — go for $40–$100+. Wild-caught silver angels still exist in the trade but the koi pattern itself is exclusively a captive-bred phenotype.

Drivers of cost: pattern quality and symmetry, orange saturation, body size at sale, captive-bred provenance from named breeders versus generic wholesale stock, and any specialty features like long fins or premium grade designations.

Acclimation#

Use a slow drip acclimation over 60–90 minutes, especially when moving fish between very different water chemistries (acidic store water to harder tap water, for example). Drop the angel in a clean bucket or breeder net with shipping water, run airline tubing siphon from the destination tank with a tied knot to drip 1–2 drops per second, and discard the bucket water rather than pouring store water into your display tank. Detailed step-by-step in the acclimating fish guide.

Quick Reference#

The keep-this-handy parameter list for adult koi angelfish:

• Tank size: 29 gallons minimum for a pair, 55+ gallons for community
• Tank height: 18 inches minimum to accommodate fin span
• Temperature: 76–84°F (80°F ideal)
• pH: 6.0–7.5 (slightly acidic preferred)
• Hardness: 3–8 dGH (soft preferred)
• Diet: Carnivore-leaning omnivore — pellets/flakes 2–3x daily, frozen 2–3x weekly
• Tank mates: Corydoras, rummy nose tetras, harlequin rasboras, dwarf gourami, bristlenose pleco
• Avoid: Tiger barbs, neon tetras, aggressive cichlids, strong flow
• Lifespan: 10–12 years typical
• Difficulty: Intermediate — sensitive to ammonia, fin damage, and pair aggression