Fish guide
Royal Gramma
Gramma loreto
A small, hardy Caribbean basslet prized for its vivid purple-and-yellow coloration, peaceful community behavior, and excellent reef compatibility.
Quick Reference
- Difficulty
- Easy
- Temperament
- Peaceful with dissimilar fish but territorial around its cave and toward other grammas or similar-looking basslets
- Adult Size
- About 3 inches (8 cm)
- Lifespan
- Approximately 5-8 years
- Minimum Tank Size
- 30 gallons
- Temperature
- 74-80°F (23-27°C)
- Salinity / Specific Gravity
- 1.023-1.026
- pH
- 8.1-8.4
- Diet
- Carnivore/planktivore
- Swimming Level
- Lower to middle levels near caves and ledges
- Social Requirement
- Best kept singly in most home aquariums; established pairs or groups require substantially more space and structure
- Minimum Group
- 1
- Reef Safe
- Yes
- Coral Safe
- Yes
- Invertebrate Safe
- Generally yes; very small crustaceans may be eaten
- Beginner Friendly
- Yes
Key Takeaways
- Difficulty: Easy
- Minimum tank size: 30 gallons
- Reef safe: Yes
- Beginner friendly: Yes
Overview
General Description: A small, hardy Caribbean basslet prized for its vivid purple-and-yellow coloration, peaceful community behavior, and excellent reef compatibility.
Appearance: The front half is violet to purple and gradually blends into a bright yellow rear half. A black stripe passes through the eye, a black spot marks the front of the dorsal fin, and fine yellow lines may radiate from the eye.
Personality: Initially shy but observant. Once established, it hovers near a preferred cave, ventures into open water to feed, and retreats quickly when alarmed.
Notable Characteristics: Often swims with its belly oriented toward nearby rock surfaces, so it may appear sideways or upside down beneath a ledge. It may also clean ectoparasites from larger fish in nature.
General Suitability: Excellent for beginner and experienced reef keepers when provided a mature, covered aquarium with several secure caves and nonaggressive tank mates.
Natural Habitat
Native Distribution: Western central Atlantic from Bermuda and the Bahamas through the Caribbean and Central America to northern South America
Ocean/Region: Tropical western Atlantic Ocean and Caribbean Sea
Depth: Commonly 1-60 m (3-197 ft), usually within about 1-40 m (3-131 ft); deeper records exist
Reef Zone/Habitat: Caves, crevices, shaded overhangs, and vertical or underslung surfaces on coral and rocky reefs
Natural Water Movement: Low to moderate within protected recesses, with stronger flow possible outside the shelter
Natural Behavior: Hovers close to shelter, aligns its belly with the nearest rock surface, retreats into recesses when threatened, and feeds on zooplankton, small crustaceans, and fish ectoparasites.
Other Habitat Notes: May occur in loose colonies where suitable shelter is abundant, but individuals maintain space around preferred caves and nesting sites.
Aquarium Setup
Minimum Tank Size: 30 gallons for one Royal Gramma
Preferred Tank Dimensions: A standard 30-gallon or larger footprint with enough horizontal rock structure to create separated caves and sight breaks
Rockwork: Abundant stable live rock or reef-safe structure with crevices, tunnels, ledges, and shaded overhangs
Hiding Places: Several caves are essential; at least one should be deep enough for the fish to retreat completely out of sight
Open Swimming Space: Provide moderate open water immediately beside the rockwork for feeding and display
Substrate: Aragonite sand is common, but the species has no special substrate requirement
Water Flow: Low to moderate near the chosen cave, with enough circulation for good oxygenation and reef health
Lighting: No special requirement for the fish; include shaded areas beneath ledges and match overall lighting to corals
Lid Requirement: Strongly recommended. Royal Grammas can jump when startled, chased, or newly introduced.
Special Setup Requirements: Create multiple cave entrances and visual barriers before introduction. A bare aquarium without secure shelter can cause chronic hiding and stress.
Water Parameters
Temperature: 74-80°F (23-27°C)
Specific Gravity/Salinity: 1.023-1.026 (approximately 32-35 ppt)
pH: 8.1-8.4
Alkalinity: 7-11 dKH, maintained consistently
Other Relevant Parameters: Ammonia 0 ppm; nitrite 0 ppm; keep nitrate controlled for the overall reef system and maintain strong oxygenation
Water Quality Sensitivity: Hardy compared with many marine fish but still vulnerable to ammonia, nitrite, low oxygen, and abrupt changes
Stability Requirements: Maintain stable temperature, salinity, pH, and alkalinity. Acclimate carefully and avoid sudden parameter corrections.
Behavior & Social Needs
General Behavior: A cave-associated, diurnal fish that alternates between hovering near shelter and short feeding excursions
Aggression: Usually peaceful toward unrelated community fish but assertive toward grammas, dottybacks, and similarly shaped or colored cave dwellers
Territorial Behavior: Defends a localized area around its preferred cave or nest and may open its mouth in a threat display
Activity Level: Moderate; active in view once comfortable but remains close to cover
Swimming Level: Lower to middle levels near rockwork
Group Requirements: Keep one in most aquariums. Groups require a large system, extensive separated shelter, and careful introduction.
Pairing: A true male-female pair may coexist and breed, but random adults are difficult to sex and can fight. Purchase a documented pair when possible.
Other Notable Behaviors: Swimming upside down under ledges is normal. The fish may spend several days hidden after introduction and may move small pieces of algae or debris when constructing a nest.
Reef Compatibility
Reef Safe: Yes
Coral Compatibility: Does not normally nip or eat corals
Invertebrate Compatibility: Generally safe with ornamental shrimp, snails, crabs, worms, and other reef invertebrates; extremely small crustaceans may be treated as food
Potential Risks: May defend a cave near a coral, chase small cave dwellers, or consume tiny ornamental crustaceans and larvae
Conditions Affecting Compatibility: Territorial behavior increases in cramped aquariums, when another fish competes for the same cave, or during nesting and spawning.
Tank Mates
Good Tank Mates: Ocellaris Clownfish, cardinalfish, firefish, peaceful gobies, watchman gobies, blennies, chromis, small peaceful wrasses, and reef-safe invertebrates
Use Caution With: Dottybacks, assessors, other basslets, territorial damsels, hawkfish, aggressive wrasses, and fish with similar purple-and-yellow coloration
Avoid: Large predators, highly aggressive fish, and additional Royal Grammas or closely related grammas in small to medium aquariums
Same-Species Compatibility: One per typical home aquarium. A confirmed pair or planned group may work only with ample volume, caves, and visual separation.
Same-Genus Compatibility: Avoid mixing Gramma species in most home systems because they use the same shelter niche and may fight
Compatibility Notes: Add the Royal Gramma before highly territorial fish when possible. Provide more caves than cave-dwelling fish and distribute them across the aquarium.
Diet & Feeding
Natural Diet: Zooplankton, small crustaceans, and ectoparasites picked from other fish
Captive Diet: A varied carnivorous marine diet of small sinking or suspended prepared foods and frozen meaty foods
Recommended Foods: Mysis shrimp, enriched brine shrimp, copepods, finely chopped krill or marine seafood, quality marine pellets, flakes, and gel foods
Feeding Frequency: Small portions once or twice daily; juveniles, thin new arrivals, and breeding fish may benefit from two or three smaller meals
Feeding Behavior: Darts from shelter to take food from the water column. It may initially wait near its cave, so distribute food where faster surface feeders cannot monopolize it.
Special Nutritional Requirements: Use varied marine protein sources and appropriately sized foods. Include carotenoid-rich or enriched foods to support condition and coloration.
Sexing & Breeding
Male/Female Differences: Males tend to be larger and may show longer pelvic fins; females are often smaller and fuller when gravid. These differences are subtle and not fully dependable for selecting a pair.
Breeding Difficulty: Moderate to difficult; adults may spawn in captivity, but collecting and raising larvae requires specialized live foods
Reproductive Strategy: Nest-spawning egg layer with male nest construction, guarding, maintenance, and egg care
Pair Formation: A mature male establishes a nest in a crevice or cave. A receptive female visits the nest to deposit eggs, often around dawn.
Spawning Behavior: The male builds a nest from algae and other material inside a cavity. The female enters to lay adhesive eggs, after which the male tends and guards the nest.
Eggs/Larvae: Eggs are deposited within the nest rather than mouthbrooded. Hatching produces small planktonic larvae that require very small prey.
Larval Care: Use a dedicated rearing tank with gentle aeration, stable water, dim controlled lighting, and cultured rotifers or copepod nauplii as first foods before transitioning to Artemia and prepared diets.
Captive Breeding Availability: Available but not common everywhere. Royal Grammas were among the earlier marine ornamentals bred in captivity, and captive-bred specimens periodically enter the trade.
Health
Common Health Concerns: Marine ich (Cryptocaryon), velvet (Amyloodinium), flukes, intestinal parasites, bacterial infections, jumping injuries, starvation from competition, and stress-related fin damage
Parasite Susceptibility: Can contract common marine ectoparasites and internal parasites; dark purple coloration can make fine spots or dusting difficult to see
Disease Susceptibility: Generally hardy after acclimation, but newly imported fish may arrive stressed, hide disease signs in caves, or stop feeding if bullied
Signs of Stress: Rapid breathing, flashing, white spots or fine dusting, clamped fins, faded color, frayed fins, loss of appetite, persistent hiding, repeated jumping, or hovering unusually far from shelter
Quarantine Considerations: Provide covered PVC fittings or inert caves in a separate cycled quarantine system. Observe respiration, skin, appetite, and feces. Do not expose reef invertebrates to copper medication.
Common Keeper Mistakes: Providing too few caves, keeping several grammas in a small tank, choosing aggressive tank mates, using an uncovered aquarium, failing to verify feeding, and confusing normal upside-down swimming with illness
Special Sensitivities: Bullying, loss of secure shelter, rapid parameter changes, ammonia and nitrite, low oxygen, and open tank gaps
Beginner Suitability
Beginner Friendly: Yes
Why: It is hardy, compact, readily accepts prepared foods, generally peaceful, vividly colored, and fully reef compatible
Major Challenges: Managing cave territory, preventing jumps, confirming a shy newcomer is eating, and avoiding aggressive or overly similar tank mates
Before You Buy
Important Considerations: Choose a fish with clear eyes and skin, intact fins, normal breathing, a rounded belly, and a demonstrated feeding response. Prepare multiple secure caves and a tight lid before introduction.
Adult Size: About 3 inches (8 cm)
Aggression: Peaceful overall but territorial toward grammas and similar cave dwellers
Reef Compatibility: Reef safe
Dietary Requirements: Carnivorous/planktivorous; requires varied small meaty marine foods
Long-Term Requirements: A stable 30-gallon-or-larger covered marine aquarium, substantial cave-rich rockwork, peaceful tank mates, and consistent feeding for roughly 5-8 years or longer
Species-Specific Information
Anything important that does not fit above: Do not confuse the Royal Gramma with the Bicolor Dottyback or False Gramma (Pictichromis paccagnellae). The Royal Gramma normally shows a gradual purple-to-yellow transition, a dark eye stripe, a black dorsal spot, and colored fins; the dottyback usually has a sharp color boundary, clearer fins, a more aggressive temperament, and no matching dorsal spot.
Frequently Asked Questions
Why does my Royal Gramma swim upside down?
This is normal. Royal Grammas orient their belly toward nearby rock surfaces in nature, so they often swim sideways along walls or upside down beneath ledges. Concern is warranted only if the fish cannot control its position or also shows rapid breathing, appetite loss, or other signs of illness.
Sources and Further Reading
- FishBase Summary: Gramma loreto FishBase Consortium