Thank you for visiting! By the way… any links on this page that lead to products on Amazon and other stores/partners are affiliate links Aquarium Store Depot earns a commission if you make a purchase.
Table of Contents
- Species Overview
- Classification
- Understanding Them
- Compatible Tank Mates
- Feeding And Nutrition
- Breeding Keyhole Cichlids
- Health And Disease Prevention
- Frequently Asked Questions
- What It Is Actually Like Living With Keyhole Cichlid
- Closing Thoughts
Keyhole cichlids are the most peaceful cichlid in the hobby, and that is exactly why most people fail with them. They get bullied by aggressive tank mates, stressed by fast moving fish, and fade into the background of busy tanks. This fish needs calm, not chaos. I have kept keyholes for years and the biggest mistake is putting them with fish that treat their timidity as an invitation to harass. Get the tank mates right and this fish is a gem. Get them wrong and it hides until it dies. The cichlid that hides behind a leaf when a tetra swims by.
The cichlid that hides behind a leaf when a tetra swims by.
What Most Care Guides Get Wrong About Keyhole Cichlid
The keyhole cichlid is criminally underrated, and the main misconception is that they’re boring. Most people see them in a store tank where they’re washed out, stressed, and hiding, and they pass them by. But in a well-planted tank with proper care, keyhole cichlids develop beautiful gold and cream coloring, and their behavior is endlessly interesting. They’re also the most peaceful cichlid I’ve ever kept. And I mean genuinely peaceful, not “peaceful for a cichlid.” They won’t bother shrimp, they won’t harass other fish, and they won’t destroy your plants. The other myth is that they don’t have personality. Keyholes are shy initially, but once settled in, they become curious, interactive fish that recognize their keepers.
The Reality of Keeping Keyhole Cichlid
Keyholes are genuinely gentle fish, and that gentleness defines everything about how you need to keep them.
They are extremely shy. New keyhole cichlids hide for days or weeks. This is normal and you cannot rush it. Forcing them into the open by removing hiding spots will stress them further. Give them caves, plants, and time.
They cannot handle aggression. Even mildly aggressive tank mates like tiger barbs or some tetras will stress keyholes into declining health. They need tank mates that are genuinely peaceful and non-confrontational.
They color up slowly. Keyholes are not flashy fish when you first get them. The colors develop gradually as they settle in and feel secure. A keyhole that has been in your tank for six months looks completely different from one you just brought home.
They are underrated. Keyholes are one of the most overlooked cichlids in the hobby because they are not aggressive or flashy. But their personality, hardiness, and community compatibility make them excellent fish for the right keeper.
Biggest Mistake New Keyhole Cichlid Owners Make
Keeping them with aggressive or even semi-aggressive tank mates. Keyholes are not equipped to handle confrontation. They shut down, stop eating, and waste away. Choose only the most peaceful community fish as companions.
Expert Take
A pair of keyhole cichlids in a heavily planted 30 gallon with corydoras and small tetras is one of the most peaceful, attractive cichlid setups you can build. If you want cichlid behavior without cichlid aggression, this is your fish.
Key Takeaways
- Keyhole Cichlids are sociable, adaptable freshwater fish that can live up to 10 years with proper care.
- Create an ideal tank setup by mimicking their natural habitat and providing plenty of cover, such as plants and caves.
- These fish prefer calmer waters and an acidic pH
- Choose compatible tank mates like corydoras catfish, larger tetras, and angelfish
Species Overview
| Scientific Name | Cleithracara maronii |
| Common Names | Keyhole Cichlid |
| Family | Cichlidae |
| Origin | South America, primarily in slow-moving waters of the Orinoco River basin |
| Diet | Omnivore |
| Care Level | Easy to Intermediate |
| Activity | Slow to Moderate |
| Lifespan | Up to 10 years |
| Temperament | Peaceful (Mildly aggressive when breeding) |
| Tank Level | Middle to bottom |
| Minimum Tank Size | 20 gallon (long format) otherwise, 30+ gallons |
| Water Temperature Range | 74°-80°F |
| Water Hardness | 5 to 20 DH |
| pH Range | 5.0. 7.0 |
| Filtration / Water Movement | Low |
| Water Type | Freshwater |
| Breeding | Egg layer |
| Difficulty to Breed | Easy to breed |
| Compatibility | Community fish |
| OK, for Planted Tanks? | Yes |
Classification
| Order | Cichliformes |
| Family | Cichlidae |
| Subfamily | Cichlinae |
| Genus | Cleithracara |
| Species | C. Maronii (Steindachner, 1881) |
Understanding Them
Keyhole Cichlids are native to the clear coastal creeks and river basins of South America and make great additions to community tanks for all levels of fish keepers. Slow moving water, rich in decaying wood, is what these freshwater creatures prefer along with their regular diet consisting of worms, crustaceans and insects.
🏆 Mark’s Take: From what I’ve heard consistently from fish store colleagues who’ve worked with them. Keyhole Cichlids are one of the most genuinely chill cichlids you can add to a community tank. They don’t carry the popularity of rams or apistogrammas, which is honestly a shame, because they’re easier to keep than either. If you want a cichlid that won’t demolish a planted community setup and gives you minimal stress, this fish deserves to be at the top of your list.
What sets them apart from others is that they can change their coloring pattern depending on threats, which makes them even more appealing! This characteristic of this fish has lead to get the nickname “chamelon cichlid.”
Fun Fact: The Keyhole Cichlid was named one of the forgotten cichlids per Tropical Fish Hobbyist Magazine.
As well as being peaceful by nature, Keyholes also like company so having multiple males or females together. They may have to bicker a little to establish their pecking order, but once they do that they should become peaceful among each other. However, one a breeding pair occurs, more aggression may occur.
Origin And Distribution
Keyhole Cichlids (Cleithracara maronii) have a wide distribution across various coastal regions, including Suriname, French Guiana, Venezuela and Guyana, as well as Trinidad & Tobago. These hardy aquarium fish need plenty of space to thrive. They inhabit small creeks and rivers, which offer the perfect habitat for young fish along with other smaller species.
Average Size
Considering their eventual adult size of 4 to 4.9 inches (10-12.5 cm), it is important for any aquarist to account for an appropriate tank space when setting up a home environment for keyhole cichlids, as they still need adequate room. They will technically qualify as dwarf cichlids to hobbyists and is kept in tanks as small as 20 gallons if the long configuration is used. Fortunately for you, this cichlid species grows slower than most.
⚠️ Size Warning: The label ‘dwarf cichlid’ is misleading here. At 4 to nearly 5 inches, Keyhole Cichlids are on the larger end of what most people expect from a dwarf species. That surprises keepers who assumed they’d stay small like an apistogramma or a pea puffer. This is one of the main reasons hobbyists feel the fish outgrew their plans. A 30-gallon minimum is a much more realistic starting point than the bare minimums you’ll sometimes see listed.
Appearance

Keyhole Cichlids, compared to other dwarf cichlid species, will seem dull in appearance with their muted colors. The body is round and compressed with muted colors that allow it to blend into the surroundings when needed, while there’s a black stripe above the eye, which contrasts effectively against this subtle coloration. The fish will become more yellow with its body color over time as it ages.
Keyholes possess an unmistakable key shaped mark on their head, giving rise to its common name. During mating season, male and female specimens become even more attractive due to changes in color. Males turning white while females take on the black bar design resulting from where they got their title of ‘keyhole cichlid.’ Adding both genders of this fish species is truly captivating for any home aquarium setup making it stand out amongst other similar types of fish.
Males are larger than females while sporting longer dorsal fins compared with a female’s rounder shaped ones. Both sexes hold equal beauty making it difficult not love this unique species!
Lifespan
When taken care of correctly, Keyhole Cichlids can live for 7-10 years in aquariums. This is quite a lengthy lifespan which makes them good companions to fish lovers who are looking for longterm enjoyment as well as educational opportunities.
To maximize the health and lifespan of these cichlids, it’s essential that their environment remains stable with optimal water parameters and few stress factors present.
Ideal Tank Setup For Keyhole Cichlids
Keyhold cichlids will need a tank at minimum of 20 gallons. However, the tall style 20 gallon will not work at this size. You will need at least a 20 gallon tank so you have enough hortizontial space so the fish will not become overly territorial.
A classic 20 gallon aquarium in its 30 inch long variant. A very popular aquarium.
Substrate And Decorations
On top of this basic setup, cover like plants or caves are essential if they want these species feeling safe, so adding decoration such as driftwood, rocks, & aquatic plants will help recreate a more organic environment similar to their native habitats, make sure not pick bright lighting nor aggressive neighbors which can easily upset them.
Fine grained substrates such as soft sand should be used to replicate their natural setting. Decorations, including driftwood and rocks, can add even more visual appeal, plus provide safe hiding spots in the tank.
This is an excellent cichlid species for a planted tank. They will not eat plants or dig them up. They will also get along with most community fish as long as you don’t keep them with smaller fish that they can fit their mouths. If you want to replicate their natural environment Cabomba or floating varieties are best for them. Heavily planted tanks are encouraged as these are known for being shy fish.
One of the easier Cabomba plant types available that is suitable for beginners. Can be grown submersed or emersed
Is the Keyhole Cichlid Right for You?
Before you commit to this species, here’s an honest assessment of whether it fits your setup and experience level.
- The most peaceful cichlid in the hobby. If you want cichlid personality without any aggression whatsoever, this is your fish.
- Excellent for planted community tanks. Won’t uproot plants, won’t eat shrimp, won’t bully tank mates.
- Need patience. They’re shy for the first few weeks and need time to settle in before showing their personality.
- Not a flashy fish. Their beauty is subtle. Cream and gold tones with the distinctive keyhole marking. If you want bright colors, look elsewhere.
- Hardy and forgiving. Tolerant of a range of water conditions and very disease-resistant once established.
- Best in groups or pairs. They’re social fish that do better with conspecifics than as singles.
Water Parameters
For your Keyhole Cichlids to stay healthy and happy, it is important to adhere to the required water parameters. The pH should be from 5.0 – 7.0 while they should have a stable temperature of 74-80°F. These fish prefer softer water as well.
Given their higher temperature requirements, they are based setup with a reliable aquarium heater to keep the temperatures stable. In addition, you should also maintain the following nutrient parameters:
Filtration And Water Flow
Creating a healthy environment for Keyhole Cichlids necessitates the need for efficient filtration, although their response to strong currents is negative. Many power filters and canister filters will be too strong for them and planted aquariums require water that is not compatible with their preference.
To mitigate this, consider keeping a heavily planted tank that will have pockets of lower water flow where your fish can feel safe. Note their colors when they are swimming, if they start to display more black marks on their body, this is a result of their reaction to stress around them. This is sometimes your first warning sign that something is amiss with their environment.
For canister filters, you can use a spray bar attachment to lessen the flow into the tank. The fish is large enough to not get sucked up by intakes, but it is the output speed that will stress them out. Others will use sponge filters, don’t I’m not a fan as I prefer to hide as much equipment as possible in my setups.
Compatible Tank Mates

Being a medium sized fish with a docile demeanor, there is a large amount of potential keyhole cichlid tank mates you can add with your Keyhole Cichlid. Possible tankmates include:
- Larger Tetras
- Cory catfish
- Angelfish
In addition, you can also consider other cichlids such as:
- Geophages
- Severums
For these fish, make sure they are either smaller or near the same size as your Keyhole cichlid when they are first introduced.
Lastly, due to these fish being naturally shy, it’s could help bring them out if you add dither fish in the tank. Look for dithers that are at least 2.5 inches long to prevent them from getting eaten.
Bad Tankmates
Avoid the following fish as they will be hostile to your Keyhole Cichlid:
- Jack Dempsey
- Red Terror
- Green Terror
- Oscars
- Jaguar Cichlid
There are a few fish I’ll include here as maybe. Sometimes they work, and other times they don’t. It’s up to you if you want to consider them. Just have a backup plan if it doesn’t work out:
Feeding And Nutrition
Keyhole Cichlids are omnivores and need a diverse diet consisting of both plant and animal based proteins. This mimics their natural habitat, where the primary sources of food are detritus, larvae, as well as small crustaceans such as shrimp.
To deliver that nutrition to them, provide them with varied dry foods like flakes or pellets alongside live insects and frozen items on occasion, all while making sure not to overfeed by monitoring portion size, as food fed should be consumed within two minutes. Ron’s Cichlid food is a great brand of food to use for these fish to ensure they get a good mix of ingredients.
Ron is an African Cichlid breeder with over 25 years in experience who created a line of food that is well balanced. A great option when you can’t use frozen foods.
Breeding Keyhole Cichlids
Breeding Keyhole Cichlids is relatively straightforward since they form pairs and bond for life as monogamous substrate spawners. To raise their success rate, providing an optimal breeding tank with the right water parameters combined with a diet containing live or frozen foods is key having a successful breeding spawn.
Female keyhole cichlids can lay up to 600 eggs at a time and both parents will actively care for their young. These eggs is laid on rocks, driftwood, plants, and even on the aquarium glass itself! A spawning site is recommended to create for them. You use flat pieces of rock, wood, or even title or pots so the fish have something to lay their eggs on.
Parental Care And Fry Development
One of the more noteworthy characteristics of Keyhole Cichlid breeding is that both male and female fish put forth exceptional efforts when it comes to caring for their eggs and larvae. The parents actively protect them from danger, seeing to it they remain safe until hatching occurs (video source).
While these fish will get more aggressive when breeding, they are not as bad as other cichlids. They will often push away a threat versus damaging or attacking tank mates. Even so, to keep fry from being eaten by other tankmates, consider moving the parents to their own breeding tank.
Once hatched, parental care will continue often lasting a few months, as they feed small organisms like infusoria or newly born brine shrimp on behalf of their fry. It is one of the most rewarding things to take part in the hobby.
Health And Disease Prevention
To properly care for Keyhole Cichlids, stay on top of water quality parameters. Some common diseases you may come across are:
- Ich
- Velvet
- Flukes
Less common ailments include infections like fin rot and columnaris.
Quarantining is your best method of prevent, though I know most hobbyist will not practice this. In the even you do not practice quarantine, keep your tank as stable and stress free as possible.
Frequently Asked Questions
What do keyhole cichlids eat?
Keyhole cichlids are omnivorous, and will eat a variety of food items such as small crustaceans, insects, larvae, worms or small fish. These fish also enjoy eating plant matter. To flakes and pellets that can be bought from the store. Frozen options are great too!
What color are keyhole cichlids?
Keyhole cichlids display a yellow-cream color, but when the fish is stressed it can change to brown. An identifiable feature of these species is their black spot situated at its center that looks like a keyhole.
What cichlids are nice?
Beginners looking for an easy, peaceful fish can find the keyhole cichlid to be a great option. Not needing much space and having hardiness on its side makes it simple to keep this species in aquariums.
What size tank do Keyhole Cichlids need?
Keyhole Cichlids require at least a 20 gallon tank long. If you do not have a long tank, then a 30 gallon would be the minimum tank size.
Are Keyhole Cichlids compatible with other fish species?
Keyhole Cichlids are harmonious with other aquatic life like larger tetras, peaceful barbs, and corydoras. As long as the fish won’t fit in its mouth and it’s hostile, your Keyhole should get along with them.
South American Cichlid Species Directory
This article is part of our South American Cichlids: Complete A-Z Species Directory. Visit the hub page to explore care guides for all 32 South American cichlid species we cover.
What It Is Actually Like Living With Keyhole Cichlid
This is the part no other care guide gives you. Forget water parameters for a minute. Here is what it is actually like to share your tank with this species.
They change color with mood. Keyholes shift between pale cream and dark brown depending on their mood. The keyhole-shaped marking on their side becomes more or less prominent. Reading their color is like reading their emotions.
They are gentle parents. Keyhole cichlids are attentive parents, but even their parental aggression is mild by cichlid standards. They escort fry around the tank without the violent territory defense you see in other species.
They thrive in planted tanks. Unlike many cichlids, keyholes leave plants alone. They do not dig, uproot, or eat plants. A densely planted tank is their ideal habitat.
They are slow eaters. Keyholes take their time with food. In a tank with fast, aggressive eaters, they get outcompeted and go hungry. Make sure food reaches them during feeding time.
How the Keyhole Cichlid Compares to Similar Species
The Bolivian ram is the closest comparison. Both are hardy, peaceful South American dwarf cichlids. Bolivian rams are more colorful and slightly more assertive during breeding. Keyhole cichlids are calmer and even more community-compatible. If you want a dwarf cichlid that will absolutely never cause problems in a community tank, the keyhole wins. If you want more color and don’t mind mild breeding aggression, the Bolivian ram is the better pick.
The festivum cichlid is another overlooked South American cichlid worth comparing. Festivums are larger (reaching 6-8 inches) and need more space, but they share the keyhole’s gentle temperament. Both are peaceful enough for community tanks with smaller fish, which is unusual for cichlids of their respective sizes. If you have a larger tank and want a similarly gentle cichlid with more physical presence, the festivum is an excellent option.
Closing Thoughts
Keyhole cichlids are proof that the quietest fish in the room still needs the right room.
Fish keepers of all levels can have a rewarding experience with the Keyhole Cichlids, thanks to their remarkable adaptability and peaceful disposition. If you want to create an environment in which these fish thrive, make sure that your tank is set up according to its natural habitat as well as providing adequate care for them.
Have you kept this fish before? Let us know your experience in the comments below. I love to hear back from my readers. Until next time!
- About the Author
- Latest Posts
I’m thrilled that you found Aquarium Store Depot! Here you’ll find information on fish, aquariums, and all things aquatics related. I’m a hobbyist (being doing this since I was 11) and here to help other hobbyists thrive with their aquariums! I adhere to a high quality Editorial Process and Review products with real life field usage and practical analysis.



Leave a Reply