Knowledge Centre · Species guidance

Peacock gudgeon care: cave spawning, pairs and why it isn't a goby

Tateurndina ocellicauda, the peacock gudgeon, is a small, peaceful, cave-loving fish from Papua New Guinea — commonly cited as reaching around 6–8cm (2.5–3 inches) as an adult — that pairs off naturally within a small group, spawns readily in a cave or similar shelter once settled, and is often sold as "peacock goby" despite not actually being a goby at all. It's a genuinely approachable community fish for a modestly sized planted tank and a reasonable choice for a beginner willing to research its specific needs first, but it isn't a safe choice around small dwarf shrimp, and getting cave provision and group dynamics right matters more here than for most similarly sized community fish. This guide covers what it actually needs, the sexing and pairing behaviour worth understanding before you buy, and the naming mix-up worth knowing about.

Before adding peacock gudgeons

May be suitable when…

You can provide a small group of four to six with caves or similar shelter, a planted, calm-water setup, and tankmates that don't include small dwarf shrimp you want to keep breeding successfully.

Reconsider when…

You're planning to keep just a single pair with no spare shelter for a losing male to retreat to, your tank has no cave-like cover at all, or protecting an existing cherry shrimp colony is a priority for the tank.

Worth knowing: males can show real territorial behaviour around a cave, particularly toward each other — more than one hiding spot spreads that pressure out rather than concentrating it on one fish.

Identification: gudgeon, not goby

Tateurndina ocellicauda is a small freshwater fish endemic to eastern Papua New Guinea, commonly sold as "peacock gudgeon" or, somewhat inaccurately, "peacock goby"[1]. It belongs to family Eleotridae — known as sleeper gobies or, in common usage, "gudgeons" — a group closely related to but genuinely distinct from true gobies (family Gobiidae)[1]. The defining anatomical difference is the pelvic fins: true gobies have them fused into a single suction-cup-like disc, while eleotrids, including this species, do not[1].

This matters practically because "goby" as a common name covers a very wide range of genuinely different fish, from the tiny bumblebee goby to the eel-like dragon goby, with different care needs across the group. Care information written specifically for true gobies shouldn't be assumed to transfer directly to this species just because a retailer used "goby" in the common name.

Adult size is widely and consistently cited across specialist care sources at around 6–8cm (2.5–3 inches), with males typically reaching the larger end of that range. We haven't traced this specific figure to one of the sources cited in this guide's own sources list below, so we're presenting it as general hobby consensus rather than attributing it to a single citation here. This is a modest, community-tank-friendly size, though it's worth planning footprint around the fuller figure rather than the smallest one you come across, consistent with how we've handled sizing uncertainty on other species guides.

Water conditions that matter most

Treat the ranges below as a practical starting point drawn from specialist care sources, not a single precise scientific target.

Gathered from specialist peacock gudgeon-keeping sources; treat as a practical range rather than one confirmed figure.
Factor	Commonly reported range	Notes
Temperature	Roughly 22–26°C (72–79°F)	A moderate tropical range.
pH	Roughly 6–8	A wider tolerance than many of the more sensitive nano community species.
General hardness	Roughly 6–12°N (moderate)	Adaptable within a fairly moderate range.
Ammonia / nitrite	Zero	As sensitive as most freshwater fish — see our ammonia and nitrite guides.

Tank setup: footprint and cover

A tank of at least around 40 litres (roughly 10 US gallons) is commonly recommended as a minimum for a pair, with more room needed to comfortably house a small group[2]. Footprint and cover matter more here than height — this is a fish that spends much of its time near the substrate and around shelter rather than swimming through open water, so a well-planted layout with fine or soft substrate, driftwood, and dense planting such as Anubias, Java fern or Cryptocoryne suits it well[2].

Floating plants such as Amazon frogbit or similar are commonly recommended too, providing shaded areas this naturally somewhat shy species uses readily[2]. Multiple cave-like hiding spots — ceramic caves, coconut shells, short lengths of pipe, or rockwork with cavities — are worth providing generously, since cover availability directly affects both general comfort and the territorial dynamics covered below.

Peacock gudgeons are described as peaceful and sociable, generally doing best in small groups of around four to six rather than a single isolated pair[3]. Within a group, compatible pairs are reported to form naturally, and males can show real territorial behaviour toward each other, particularly around spawning caves, though this is generally described as non-aggressive posturing rather than serious, damaging conflict[3].

Providing more than one cave-like shelter spreads that territorial interest across more than one spot, giving a less dominant male somewhere else to retreat to rather than being persistently displaced from the only option available. On sex ratio: since compatible pairs are reported to form on their own within a mixed group rather than needing to be pre-matched, a roughly even mix of males and females in a group of four to six is a reasonable starting point, with slightly more females than males sometimes suggested as one way to reduce how much territorial pressure concentrates on any single cave — though we found no dedicated study establishing one ratio as reliably better, so treat this as a sensible starting point rather than a firm rule.

A group arrangement that isn't working out tends to show a consistent pattern rather than one-off squabbling: the same individual persistently excluded from every available cave, visible fin damage rather than brief posturing, or one fish spending most of its time in the open rather than using shelter at all despite caves being available. Any of those, especially together, is worth treating as a sign to add more shelter or reconsider the group's composition, not something to wait out.

Telling males and females apart

Sexual dimorphism in this species is reported as fairly reliable once fish are mature and well conditioned. Males tend to be slightly larger, more intensely coloured, and develop a rounded nuchal hump on the forehead; females tend to have a more streamlined body shape, a brighter yellow belly colouration, and a dark bar running along the edge of the anal fin[4]. Young or recently added fish that haven't settled in and coloured up fully can be harder to sex confidently than established, well-fed adults.

Cave spawning and territorial behaviour

This species is a cave spawner, and is widely described as one of the more straightforward community fish to breed given the right setup: provide a small cave or a short length of PVC pipe, condition a compatible pair with regular live and frozen foods, and a female will typically lay eggs inside the cave for the male to guard and fan until they hatch, usually within around five to seven days depending on temperature[3].

Whether or not breeding is your goal, a cave-spawning species benefits from cave-like shelter being available as a matter of course — it's a normal, expected use of the habitat, not a special setup only needed if you're actively trying to breed the fish.

Feeding preferences

Peacock gudgeons are omnivorous and generally good feeders, taking a range of small live, frozen and prepared foods. Live and frozen meaty foods — brine shrimp, daphnia and similar — are commonly used both for general feeding and specifically to bring a pair into breeding condition[3], alongside quality sinking pellets or granules suited to their generally lower-water-column feeding habit.

Tank mates and shrimp/fry compatibility

Peacock gudgeons are generally peaceful toward similarly sized, non-aggressive community fish, but they are reported to prey on small dwarf shrimp, particularly cherry shrimp and other similarly sized Neocaridina, especially younger or smaller individuals[5]. If keeping shrimp alongside them matters to you, larger, more robust species such as Amano shrimp are commonly suggested as a meaningfully safer option than small dwarf shrimp[5].

Mouth size is a more useful way to think about this than a fixed species list: anything small enough to fit in a peacock gudgeon's mouth is a plausible target, which is why shrimplets and very young fry are at meaningfully more risk than adult shrimp or established fish of a similar species. An adult cherry shrimp population isn't automatically safe just because the adults themselves are too large to eat — ongoing breeding success is still likely to suffer if the newest shrimplets are consistently picked off before they grow past that size. We're not aware of a source establishing this as a guarantee either way, so treat "adult shrimp might be fine, a breeding colony probably won't stay that way" as the honest, uncertain version of this rather than a confident guarantee in either direction.

The same predatory instinct applies to very small fish fry generally, worth bearing in mind in a mixed community tank with other breeding species. Separately, very slow-moving, timid or heavily long-finned fish aren't an ideal match either — not because peacock gudgeons are aggressive toward them, but because a nervous, easily displaced tankmate can struggle to compete for food or cave space against a species that's confidently territorial around its own shelter. See our guide to choosing tank mates for a broader framework on working through a stocking decision like this one.

Normal behaviour

Hovering low in the water column near cover — typical, expected positioning for this species.
Males posturing or briefly sparring near a cave entrance — normal territorial behaviour, distinct from sustained, injurious aggression.
A pair spending extended time together near a chosen cave — consistent with normal pairing and pre-spawning behaviour.
Brief retreat into shelter when startled — a normal, mildly cautious response, not chronic hiding.

Warning signs and what to check first

None of the signs below confirms a specific problem on its own. Each has more than one possible explanation, and reacting immediately — especially with a large water change or a new product — before checking the more likely causes can make things worse.

One male persistently chased away from every cave

What it might mean: Too few hiding spots relative to the number of males, concentrating territorial pressure onto the least dominant fish.

What else could explain it: A genuinely unwell fish being targeted as the weaker individual.

Check this first: Number of caves/shelters versus number of males, and whether the affected fish shows other signs of illness.

Don't: Assume persistent, one-sided displacement will resolve itself without adding more shelter options.

A previously stable cherry shrimp population declining after gudgeons are added

What it might mean: Predation on smaller or younger shrimp, a documented risk with this pairing.

What else could explain it: An unrelated water-quality or breeding-cycle issue coinciding with the timing.

Check this first: Whether the decline is specifically among smaller/younger shrimp, and general water parameters.

Don't: Assume the two are unrelated just because the gudgeons look otherwise well settled.

Eggs in a cave that never hatch, or a guarding male that abandons them

What it might mean: Unstable water parameters, an inexperienced first-time pair, or disturbance to the guarding male.

What else could explain it: A normal, common outcome for an early breeding attempt, particularly from a young or first-time pair.

Check this first: Water stability (ammonia, nitrite, temperature) and whether the cave area has been repeatedly disturbed.

Don't: Intervene by physically moving the eggs unless you have a specific, considered reason to — this can disrupt normal guarding behaviour further.

Common mistakes

Keeping a single pair with no spare shelter, rather than a small group with multiple cave options.
Assuming "peacock goby" implies true-goby care needs, when this species is actually a gudgeon (family Eleotridae).
Keeping small dwarf shrimp alongside them and being surprised when the population declines.
Providing no cave-like cover at all, removing a habitat feature this species relies on for normal, comfortable behaviour.
Sexing fish before they're mature and well conditioned, when dimorphism is far less obvious in young or unsettled fish.

How AquaPulse can help

AquaPulse doesn't sex your fish or manage cave placement for you, but it can help with the water-chemistry side of a breeding attempt or a general community setup: logging readings with Water Check gives you a plain-language read on ammonia, nitrite, pH and temperature trends over time — useful context if a spawning attempt fails and you're trying to rule out water instability as a factor.

Frequently asked questions

Is a peacock gudgeon actually a goby?

No, and the common alternative name "peacock goby" is a genuine misnomer. True gobies (family Gobiidae) have fused pelvic fins forming a suction disc; the peacock gudgeon lacks that feature and instead belongs to family Eleotridae, the sleeper gobies or "gudgeons" — a related but distinct group. It's a small, taxonomic-sounding distinction, but it matters if you're cross-referencing care advice written for true gobies, which doesn't automatically transfer.

Can I keep peacock gudgeons with cherry shrimp?

It's genuinely risky and worth avoiding if protecting the shrimp population matters to you. Peacock gudgeons are reported to prey on small dwarf shrimp such as cherry shrimp, particularly younger or smaller individuals. Larger, more robust shrimp like Amano shrimp are commonly suggested as a safer alternative if you want shrimp in the same tank.

How can I tell male and female peacock gudgeons apart?

Reasonably reliably once they're mature. Males tend to be slightly larger, more intensely coloured, and develop a noticeable rounded hump on the forehead (a nuchal hump); females tend to have a more streamlined body shape, a brighter yellow belly, and a dark bar along the edge of the anal fin. These differences are described as fairly consistent, though young or unconditioned fish can be harder to sex confidently.

Do peacock gudgeons need a cave to be happy, or only to breed?

Providing one is worth doing regardless of whether you want them to breed. Cave-like shelter matches this species' natural sheltering and spawning behaviour, and having that option available is more consistent with normal, comfortable behaviour than a wide-open tank with nowhere to retreat to — breeding is simply a more visible, deliberate use of the same kind of shelter, not a separate need.

How big do peacock gudgeons get?

Specialist care sources commonly cite around 6–8cm (2.5–3 inches) as an adult, with males typically reaching the larger end of that range. It's a modest, community-tank-friendly size, but worth planning tank footprint and cave provision around the fuller figure rather than the smallest one you find.

Is a peacock gudgeon a good beginner fish?

Reasonably, for a beginner who researches its specific needs first rather than treating it as a generic small community fish. It's peaceful, a fairly easy feeder, and tolerant of a moderate water-parameter range, but it does have two genuine requirements a true beginner-proof fish wouldn't: reliable cave-like shelter, and stocking it in a proper small group rather than a single pair. Get those two things right and it's a manageable, rewarding species even for someone fairly new to the hobby.

Sources and uncertainty

Published: 30 July 2026
Last reviewed: 20 August 2026
Written and maintained by: AquaPulse (Valeon Labs Ltd)

This guide draws on specialist peacock gudgeon-keeping sources for husbandry, breeding, sexing and compatibility guidance, since we could not confirm a direct ITIS species-level taxonomic serial number for this species during research and did not want to cite one we couldn't verify. We've been explicit about which figures reflect specialist/hobbyist consensus rather than a formal study. This review pass added an adult-size figure, sex-ratio and beginner-suitability guidance, and a mouth-size framing for shrimp/fry predation risk, drawing on the same sources already cited plus our own practical reasoning where flagged as such. We'll update this page if we find something we've got wrong.

Good to know: This guide provides general informational guidance only. It is not a substitute for specialist aquatic-veterinary advice.

[1] Wikipedia — "Peacock gudgeon" Secondary orientation source, used for general family-level classification (Eleotridae vs Gobiidae) and the pelvic-fin distinction between gudgeons and true gobies, and native range (eastern Papua New Guinea) — not used as the basis for any husbandry or numeric claim.
[2] Aqua-Fish.Net — "Peacock Gudgeon (Tateurndina ocellicauda) Care" Specialist hobbyist source. Used for minimum tank size and general tank-setup/planting recommendations. Not a scientific authority.
[3] Build Your Aquarium — "Peacock Gudgeon Care Sheet: Tank Mates, Feeding, and Breeding" Specialist hobbyist source. Used for group-size/social behaviour, cave-spawning and breeding process, and feeding/conditioning guidance. Not a scientific authority.
[4] FishLore aquarium forum — "How to tell difference between a male and female peacock goby" Specialist hobbyist community source. Used for reported sexual dimorphism features (nuchal hump, body shape, colouration, anal fin marking). Treated as hobbyist-reported observation, not a scientific authority.
[5] AquaWorldHub — "Peacock Gudgeon Tank Mates: Compatible Fish For A Harmonious Aquarium" Specialist hobbyist source. Used for shrimp-predation risk and the Amano-shrimp-as-safer-alternative recommendation. Not a scientific authority.

What we deliberately left out: a confirmed ITIS taxonomic serial number, since our research did not return a directly verifiable species-level record for Tateurndina ocellicauda; a precise lifespan figure, since we found no dedicated longevity study and hobbyist estimates varied; a firm recommended male-to-female ratio, since we found no dedicated study establishing one ratio as reliably better than an even mix; and a guarantee about adult shrimp safety around this species, since mouth size is a reasonable general principle but we found no source confirming it holds for every individual fish or every shrimp species.