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

A practical next step

Plan your aquarium with professional support

Hydro Habitats helps New Jersey clients design, install, and care for aquatic systems.

Explore Aquarium Design & Installation