Encyclopaedia

FishMarineEasy
©AI Generated·Proprietary

Butterfly wrasse

Halichoeres papilionaceus

Halichoeres papilionaceus is a colorful wrasse native to the Western Indo-Pacific. It is an active fish that requires a deep, fine sand bed to bury itself at night.

Taxonomy
Class:Actinopteri
Order:Perciformes
Family:Labridae
Genus:Halichoeres
Species:Halichoeres papilionaceus

Share

Check out Butterfly wrasse on Atlarium

PracticeRecognition quizzesPhotos, names, origins, and puzzles to review Atlas species.Open quizzes
Water Temperature

23 - 27 °C

pH Value

8.1 - 8.4

Water type

Marine

Tank level

Bottom

Adult size

12 cm

Minimum tank volume

>= 150 L

Minimum group

>= 1

KH

8 - 12 dKH

Species description

Geographical Origin and Habitat:
This species is widely distributed across the Western Indo-Pacific, ranging from the waters of Indonesia and the Philippines to Papua New Guinea and the Great Barrier Reef in Australia. It inhabits shallow coastal lagoons, rocky reefs, and seagrass beds at depths between 1 and 15 meters. It is closely associated with sandy areas mixed with rubble and rock, where it actively searches for food.
Taxonomy and Morphology:
Belonging to the family Labridae, Halichoeres papilionaceus features an elongated, moderately compressed body with a conical head and a terminal mouth equipped with small canine-like teeth. These teeth are specialized for seizing benthic invertebrates from the substrate. Adults reach a maximum total length of approximately 12 centimeters, showing an aerodynamic profile for swift swimming.
Social Behavior:
It is a diurnal, highly active, and curious swimmer. During the day, it continuously patrols the substrate for prey. At dusk or when startled, it dives headfirst into the sand bed to sleep fully buried, leaving only its eyes exposed. It exhibits moderate intraspecific territoriality but is generally peaceful toward other species.
Coloration and Sexual Dimorphism:
The coloration is highly variable, dominated by greenish-red or brown hues, with a complex pattern of iridescent yellow, pink, and blue spots and stripes on the head and body. It features a distinctive black spot (ocellus) on the dorsal fin and often another on the caudal peduncle. Adult males are significantly more colorful and larger than females.

Care, breeding and tankmates

Aquarium Setup:
Requires a mature marine aquarium of at least 300 liters. The most critical requirement is a deep bed of fine sand (at least 5-8 cm, non-silica sand) on the bottom, which is essential for the fish to bury itself to sleep. The rockwork must be placed securely on the aquarium glass floor to prevent collapses caused by the fish's burrowing activities.
Diet and Feeding:
An opportunistic carnivore feeding on small crustaceans, mollusks, polychaete worms, and other benthic invertebrates. In the aquarium, it readily accepts frozen foods such as mysis shrimp, brine shrimp, chopped krill, and clam meat. Over time, it will accept high-quality pellets and flakes. It is useful for controlling flatworms and pyramidellid snails.
Water Quality:
Requires stable and well-filtered marine parameters: temperature between 24°C and 27°C, pH range from 8.1 to 8.4, specific gravity (SG) of 1.020 to 1.025, and carbonate hardness (KH) of 8 to 12 dKH. Ammonia and nitrite must be zero, with nitrates kept below 20 ppm through regular water changes and filtration maintenance.
Compatibility and Cohabitation:
Peaceful toward tankmates of similar size or larger, but it may prey on small ornamental shrimps, crabs, and tiny snails. It is completely reef safe regarding corals. It coexists well with tangs, clownfish, and other peaceful wrasses. Avoid keeping multiple specimens of the same species in the same tank unless it is very large.
Aquarium Breeding:
Captive breeding has not been recorded in home aquariums. In nature, they are protogynous sequential hermaphrodites (females can transition to males) and broadcast spawners. Gametes are released into the water column, and the resulting pelagic larvae are extremely difficult to rear in closed systems due to their micro-food requirements.
Risks and Diseases:
The main risk is skin or mouth damage if the aquarium lacks a proper sand bed. Attempting to burrow into coarse gravel can cause severe abrasions, leading to secondary bacterial infections. It is moderately susceptible to marine ich (Cryptocaryon irritans). A quarantine period with a container of fine sand is recommended.

Geographic Origin and Distribution

This species is widely distributed across the Western Indo-Pacific, ranging from the waters of Indonesia and the Philippines to Papua New Guinea and the Great Barrier Reef in Australia. It inhabits shallow coastal lagoons, rocky reefs, and seagrass beds at depths between 1 and 15 meters. It is closely associated with sandy areas mixed with rubble and rock, where it actively searches for food.

Origin

Tropical oceans and reefsAfrica and MadagascarSouth and Southeast AsiaAustralia, New Guinea, and Oceania

Fish profile

Temperament
Peaceful
They are constantly on the move during daylight hours. While usually peaceful, they are opportunistic predators. Their bold nature makes them a fascinating addition.
Diet
Carnivore
They are carnivores feeding on benthic invertebrates. In the aquarium, offer meaty foods like mysis shrimp. Providing a varied diet maintains their vibrant colors.
Sex ratio
Solitary
It is best to keep them singly. Adding multiple males results in severe aggression. A group of females might establish a pecking order.
Feeding frequency
Twice daily
They are highly active with a fast metabolism. Feeding them two to three times a day is ideal. Small frequent meals help reduce aggression.
Bioload
This species contributes a moderate bioload. They produce moderate waste due to their diet. A good skimmer and regular water changes are required.
Flow
Moderate
They originate from reef environments with strong water movement. Good water flow helps oxygenate the water. Varying flow patterns mimics their natural habitat well.
Jump risk
Yes
Wrasses are notorious for jumping out of aquariums. A tight-fitting lid or screen mesh is mandatory. Ensure all gaps are properly covered to prevent escape.
Reproduction
Oviparous
These fish are broadcast spawners in the water column. Breeding in captivity is extremely rare. Specialized setups with deep tanks and planktonic food are required.
Compatibility & tankmates
With caution
They are generally peaceful towards other fish. However, they may become territorial with other wrasses. Use caution as they might eat small ornamental crustaceans.
Tank level
Bottom
They actively swim in the mid-water regions. They require a deep fine sand bed to sleep. Coarse substrate can damage their bodies and should be avoided.

Window to the official scientific data of the species

Data synced on: 06/15/2026

Scientific Parameters & Models

Trophic level
3.4 ± 0.5 se
Resilience
High (less than 15 months)
Phylogenetic uniqueness (PD50)
0.5
Bayesian Length-Weight
a = 0.01, b = 3.09
VulnerabilityLow vulnerability (10 / 100)

Image gallery

Licensed images linked to the species or, when marked, to the closest representative taxon.

Related species

Recommendations grouped by close relatives, companion choices, and similar care.

Variants and close relatives

Same atlas type, nearby scientific identity, genus, or family.

Blackear Wrasse

Blackear Wrasse

Halichoeres poeyi

View details->
Black Wrasse

Black Wrasse

Halichoeres adustus

View details->
Clown wrasse

Clown wrasse

Halichoeres maculipinna

View details->
Cocos Girdled Wrasse

Cocos Girdled Wrasse

Halichoeres discolor

View details->
Wounded Wrasse

Wounded Wrasse

Halichoeres chierchiae

View details->
Golden-ear Wrasse

Golden-ear Wrasse

Halichoeres melanotis

View details->
Chameleon Wrasse

Chameleon Wrasse

Halichoeres dispilus

View details->
Elegant coris

Elegant coris

Coris venusta

View details->
Crescent-tail Hogfish

Crescent-tail Hogfish

Bodianus sepiacaudus

View details->
Eightline flasher wrasse

Eightline flasher wrasse

Paracheilinus octotaenia

View details->
Girdled Wrasse

Girdled Wrasse

Cirrhilabrus balteatus

View details->
Labout's Fairy Wrasse

Labout's Fairy Wrasse

Cirrhilabrus laboutei

View details->
Lined fairy wrasse

Lined fairy wrasse

Cirrhilabrus lineatus

View details->
New Guinea wrasse

New Guinea wrasse

Anampses neoguinaicus

View details->
Queen coris

Queen coris

Coris formosa

View details->
Ruby fairy wrasse

Ruby fairy wrasse

Cirrhilabrus rubeus

View details->

Recommended companions

Compatible cards from coherent ecosystems with matching parameters.

Grape caulerpa
Plant

Grape caulerpa

Caulerpa racemosa

View details->
Caulerpa prolifera
Plant

Caulerpa prolifera

Caulerpa prolifera

View details->
Caulerpa taxifolia
Plant

Caulerpa taxifolia

Caulerpa taxifolia

View details->
Chaetomorpha macroalgae
Plant

Chaetomorpha macroalgae

Chaetomorpha linum

View details->
Dead man fingers algae
Plant

Dead man fingers algae

Codium fragile

View details->
Halimeda macroalgae
Plant

Halimeda macroalgae

Halimeda opuntia

View details->
Peacock tail algae
Plant

Peacock tail algae

Padina pavonica

View details->
Red gracilaria
Plant

Red gracilaria

Gracilaria parvispora

View details->
Red grape algae
Plant

Red grape algae

Botryocladia uvaria

View details->
Sea lettuce
Plant

Sea lettuce

Ulva lactuca

View details->
Red Mangrove
Plant

Red Mangrove

Rhizophora mangle

View details->

Similar care

Cards with similar requirements, difficulty, habitat, and husbandry profile.

Temminck's Fairy Wrasse

Temminck's Fairy Wrasse

Cirrhilabrus temminckii

View details->
Black combtooth blenny

Black combtooth blenny

Ecsenius namiyei

View details->
Red-headed fairy wrasse

Red-headed fairy wrasse

Cirrhilabrus solorensis

View details->
Tono's Fairy Wrasse

Tono's Fairy Wrasse

Cirrhilabrus tonozukai

View details->
Yelloweye Combtooth Blenny

Yelloweye Combtooth Blenny

Ecsenius opsifrontalis

View details->
Lubbock's fairy wrasse

Lubbock's fairy wrasse

Cirrhilabrus lubbocki

View details->
Redfin Fairy Wrasse

Redfin Fairy Wrasse

Cirrhilabrus rubripinnis

View details->
Deep-water Wrasse

Deep-water Wrasse

Cirrhilabrus bathyphilus

View details->
Orange-back Fairy Wrasse

Orange-back Fairy Wrasse

Cirrhilabrus aurantidorsalis

View details->
Beau's Fairy Wrasse

Beau's Fairy Wrasse

Cirrhilabrus beauperryi

View details->
Flame wrasse

Flame wrasse

Cirrhilabrus jordani

View details->
Beautiful-cheek shrimpgoby

Beautiful-cheek shrimpgoby

Amblyeleotris callopareia

View details->
Erdmann's dottyback

Erdmann's dottyback

Pseudochromis erdmanni

View details->
Twospot Slender Hogfish

Twospot Slender Hogfish

Bodianus bimaculatus

View details->
Beautiful Blenny

Beautiful Blenny

Ecsenius pulcher

View details->
Allen's blenny

Allen's blenny

Ecsenius alleni

View details->
Last updated: 06/30/2026
Butterfly wrasse (Halichoeres papilionaceus) Care Guide & Tank Setup | Atlarium