Pyramid Butterflyfish Care: The Ultimate Reef-Safe Schooling Fish

Species Overview#

The Pyramid Butterflyfish (Hemitaurichthys polylepis) is the answer to a question most reef keepers thought impossible: a butterflyfish you can actually trust around your corals. While the broader Chaetodontidae family is famous for picking apart prized SPS colonies and Acropora tips, this Indo-Pacific species evolved on a completely different food source — drifting plankton swept up from deep reef walls. That single dietary quirk transforms it from "tank wrecker" to one of the most graceful schooling additions a large reef can host.

Bold yellow flanks meet a triangular wedge of pure white that gives the fish its name, and a healthy school cruising mid-water in a 180-gallon reef looks more like a freshwater tetra display than a typical marine setup. They are hardy once acclimated, peaceful with corals, peaceful with most fish, and willing to take prepared foods within days of being introduced — provided you buy the right specimen from the right vendor.

Adult size

7 in (18 cm)

Lifespan

7-10 years

Min tank

100 gallons

Temperament

Peaceful schooling

Difficulty

Intermediate

Diet

Planktivore

Identification: The Iconic White "Pyramid" and Yellow-Orange Flanks#

The body pattern is unmistakable and one of the easiest IDs in the saltwater hobby. The face and forehead are a charcoal-to-black gradient, the dorsal half of the body is solid yellow-orange, and a wide triangular wedge of pure white runs from the belly up to the dorsal fin — the eponymous "pyramid." The caudal peduncle and tail return to bright yellow. Adults reach about 7 inches with a deep, laterally compressed body that allows the rapid mid-water turns they use to chase plankton.

Hobbyists sometimes confuse this fish with the Zoster Butterflyfish (Hemitaurichthys zoster), which carries a similar white wedge but on a much darker, brown-black body with no yellow flanks. The "Yellow Pyramid Butterflyfish" trade name almost always refers to H. polylepis — there is no separate species under that label, just a marketing variation.

Natural Habitat: Indo-Pacific Drop-offs and Plankton-Rich Currents#

In the wild, Pyramid Butterflyfish congregate in large schools — sometimes hundreds of individuals — along steep outer-reef drop-offs from Hawaii through the Indo-West Pacific. They orient into the current, hovering 5 to 30 feet off the wall, and pick zooplankton out of the water column as it sweeps past. This is fundamentally a high-energy, oxygen-rich, mid-water environment. Replicating that flow profile in captivity is the single biggest difference between a Pyramid that thrives and a Pyramid that slowly wastes away.

Size and Lifespan: Reaching 7 Inches and Living 7-10 Years#

A captive Pyramid Butterflyfish typically tops out at 6 to 7 inches and lives 7 to 10 years when fed a varied planktivore diet and kept in a tank large enough to swim freely. Reports of 12-year specimens exist in public aquariums, but home tanks rarely match that ceiling. Most premature deaths happen in the first 60 days post-arrival — almost always traced back to a fish that was never confirmed eating prepared foods at the wholesaler or local store.

Water Parameters & Tank Requirements#

Pyramid Butterflyfish are reef-grade fish that need reef-grade stability. They will not tolerate the parameter swings a hardy damsel might shrug off, and they consume oxygen at a higher rate than most reef inhabitants because of their constant mid-water swimming.

Tank Size: Minimum 100+ Gallons for Swimming Room#

A single Pyramid can be kept in a 75-gallon system if the footprint is wide enough to allow lateral swimming, but 100 gallons is the practical floor. For a school of three — which is how this species shows its best behavior — plan on 125 gallons minimum and 180 gallons or more for a true display. Tank length matters more than total volume: a 6-foot tank serves a school far better than a tall 4-foot cube of equivalent gallons.

Flow and Oxygenation: Simulating High-Energy Reef Slopes#

This species evolved in surge zones where dissolved oxygen sits near saturation and water turns over many times per minute. In captivity, that means heavy gyre flow from two opposing powerheads producing 30-50x tank turnover, plus a properly tuned protein skimmer running 24/7. Skip the skimmer or undersize the powerheads and the Pyramid will be the first fish to show stress — clamped fins, faster gill rate, and reluctance to leave a back corner.

A surface-agitating return or a small wavemaker aimed at the water surface adds the gas exchange these fish require. If your reef already houses an Achilles Tang or other oxygen-demanding species, you are most of the way to the right setup.

Specific Parameters: Temp 72-78°F, pH 8.1-8.4, SG 1.023-1.025#

Standard reef parameters work well for H. polylepis. Stability matters far more than chasing exact numbers — a tank that swings between 76 and 80 over the course of a day will stress this fish faster than one that holds steady at 79. Use the table below as a target.

Diet & Feeding#

This is the section that makes or breaks a Pyramid Butterflyfish purchase. Get the food right and they are nearly bulletproof. Get it wrong and you will watch a $100+ fish slowly starve in a tank full of food it does not recognize.

Planktivore Nutrition: Why They Differ from Coral-Eating Butterflies#

Most butterflyfish are obligate corallivores — they pick polyps off SPS and LPS colonies and cannot survive on any other food. Pyramid Butterflyfish are a rare evolutionary departure. Their diet in the wild is almost entirely zooplankton: copepods, larval crustaceans, fish eggs, and tiny pelagic invertebrates drifting in the open water column above the reef. They are physically incapable of efficiently eating coral, which is precisely why they leave your colonies alone.

This means their nutritional needs more closely resemble Bartlett's Anthias or other planktivores than they do their butterflyfish cousins like the Copperband Butterflyfish or Raccoon Butterflyfish.

Recommended Foods: Mysis, Vitamin-Enriched Brine, and High-Quality Flakes#

A good rotation looks like this: frozen mysis shrimp as the staple, vitamin-enriched (Selcon-soaked) brine shrimp two or three times a week, a high-quality marine flake or small pellet for between-feeds nutrition, and live blackworms or live brine reserved as appetite stimulants for new arrivals. Many keepers also dose a refugium-cultured pod population — a Pyramid will pick at copepods as they drift into the display, replicating wild grazing behavior.

Avoid feeding only frozen brine shrimp. Brine alone is nutritionally hollow and will result in slow wasting over months even though the fish appears to "eat well."

Feeding Frequency: Multiple Small Feedings to Maintain Body Weight#

Plan on three to four small feedings per day, not one or two large ones. These fish evolved to eat constantly throughout the day as plankton drifted past, and their bodies are not built to store much energy between meals. A "pinched" or hollow stomach behind the gills is the first visible sign of underfeeding and is the single most common chronic health issue in this species.

Tank Mates & Compatibility#

This is one of the most peaceful butterflyfish in the trade. They do not nip, do not chase, and do not defend territory in a captive environment. Compatibility issues run in the other direction — you need to make sure nothing else in the tank bullies them.

Reef Safety: Why They Are Considered "Reef Safe with Caution" (and Why They Usually Pass)#

The "with caution" caveat exists because the fish is, technically, a butterflyfish — and the family's reputation forces vendors to hedge. In practice, Pyramid Butterflyfish are reef safe with virtually all stony corals, soft corals, mushrooms, and zoanthids. The only credible risk is occasional curiosity-pecking at clam mantles or feather-duster crowns, and even that is uncommon in well-fed specimens. For SPS-dominant reefs they are arguably the safest mid-water schooler available.

Schooling Behavior: Keeping Groups of 3+ in Large Systems#

In tanks 125 gallons and larger, keep them in groups of three, five, or seven. Odd numbers reduce the chance of a single fish being singled out by one dominant individual. Single Pyramids do fine alone in smaller systems, but a school is where the species genuinely shines — synchronized turns, mid-water hovering against the flow, and a constant sense of calm motion in the upper third of the tank.

Compatible Neighbors: Tangs, Anthias, and Peaceful Wrasses#

Excellent tankmates include Lyretail Anthias, Dispar Anthias, Yellow Tangs, Tomini Tangs, Kole Tangs, Naso Tangs, Melanurus Wrasses, Mystery Wrasses, Ocellaris Clownfish, Banggai Cardinalfish, and Firefish Gobies. Avoid large angelfish, aggressive triggerfish, dottybacks (which often bully shy planktivores in the first week), and anything large enough to view a 7-inch butterflyfish as prey.

Common Health Issues#

Pyramid Butterflyfish are hardy once established. The vulnerable window is the first 30 to 60 days after introduction, and almost every problem traces back to either acclimation stress or skipped quarantine.

Acclimation Stress: Managing Shipping Sensitivity#

Wild-collected planktivores ship poorly. They burn glycogen rapidly during transit, and a fish that arrives gaunt is a fish that may never recover. Drip-acclimate slowly over 60-90 minutes, dim the display lights for the first 24-48 hours, and offer live food as the very first meal. Resist the urge to chase the fish around the tank with a net to inspect it — every disturbance in the first week sets the timeline back.

A practiced drip acclimation procedure is non-negotiable for this species. Plop-and-drop survival rates are dismal compared to a proper 90-minute drip.

External Parasites: Monitoring for Marine Ich and Velvet#

Like most wild-caught reef fish, Pyramids are susceptible to Cryptocaryon irritans (Marine Ich) and the more aggressive Amyloodinium ocellatum (Marine Velvet). A 4 to 6 week quarantine in a separate, sterile QT system with copper or tank-transfer treatment is the single most important step you can take. Skipping QT is the most common reason hobbyists lose Pyramid Butterflyfish — and often the rest of their display along with it.

Where to Buy & What to Look For#

Pyramid Butterflyfish are almost always wild-caught from Hawaii, the Marshall Islands, or other Indo-Pacific collection points. Captive breeding has not been commercialized for this species, so source quality is everything.

Selecting Healthy Specimens: Checking for "Pinched" Stomachs and Active Swimming#

Healthy specimens hover mid-water, ventilate calmly (under 80 gill beats per minute), and show full, rounded body condition just behind the gills. A "pinched" or sunken belly behind the head is the universal warning sign — that fish has been off food long enough to start metabolizing muscle, and the prognosis is poor even with perfect care at home.

Local Fish Store (LFS) Inspection: The Pyramid Butterflyfish Feeding Test#

This is the single most important step. A Pyramid that has not transitioned from wild plankton to captive food is a fish on a countdown timer regardless of how good your reef is. Before you hand over a credit card, run through the following questions with the store owner — and watch them feed the fish.

Ask the LFS owner directly:

1. How long has this specimen been in your system?
2. What is it currently eating?
3. Will you feed it for me right now, in front of me, before I buy?
4. Has it accepted frozen mysis? Frozen brine? Pellets or flakes?
5. Have you observed it picking at the rockwork or chasing pods?
6. Is it housed alone or with other fish, and if so, who eats first?
7. Has it been quarantined and copper-treated, or is it tank-transfer-fresh?

A reputable store will happily feed the fish on demand. If they refuse, hedge, or claim "it just ate, you'll have to take my word for it," walk away. A specimen that does not aggressively eat frozen mysis in front of you in the store will likely not eat in your tank either.

For a deeper look at building out the system this fish belongs in, see our saltwater aquarium guide and our broader saltwater fish overview.

Quick-Reference Cheat Sheet#