Saltwater Fish · Gramma
Royal Gramma Care Guide: The Vibrant Reef Basslet
Gramma loreto
Learn how to care for the Royal Gramma (Gramma loreto). Expert tips on reef compatibility, diet, water parameters, and choosing healthy fish at your LFS.
Species Overview#
The Royal Gramma (Gramma loreto) is one of the most recognizable fish on Caribbean reefs and one of the most forgiving saltwater species you can buy. The front half of the body is electric magenta-purple. The back half is bright yellow. The transition between the two colors looks like someone pressed two different fish together at the midline. A small black stripe runs through the eye, and a single black spot marks the front of the dorsal fin.
These fish stay small (3 inches), live 5 to 6 years in a well-kept tank, and accept almost any prepared marine food. They have been a staple of the saltwater hobby since the 1970s for one simple reason: they survive the early-stage mistakes that kill more delicate species.
- Adult size
- 3 in (8 cm)
- Lifespan
- 5–6 years
- Min tank
- 30 gallons
- Temperament
- Peaceful (territorial in caves)
- Difficulty
- Beginner
- Diet
- Carnivore
Royal Grammas check every box new reefers want — hardy enough to handle minor parameter swings, 100% reef-safe with corals and inverts, and brilliantly colored without fading in captivity. Pair one with a captive-bred clownfish and you have a complete display in a 30-gallon tank.
Identifying Gramma loreto vs. False Gramma (Pseudochromis porphyreus)#
The Royal Gramma is constantly confused at the LFS with the Royal Dottyback (Pseudochromis porphyreus), sometimes called the False Gramma. The two fish look similar at a glance — both purple, both small, both cave-dwellers — but they behave very differently in a community tank.
Look for the color split. A true Royal Gramma has a sharp magenta-to-yellow transition near the middle of the body. The Royal Dottyback is solid purple from head to tail, with no yellow. Royal Grammas also carry a small black eye stripe and a black dorsal spot the dottyback lacks.
The Royal Dottyback (Pseudochromis porphyreus) is sold in the same tanks at many stores and looks superficially similar — but it is far more aggressive. A dottyback in a peaceful community tank will harass small fish, kill ornamental shrimp, and bully clownfish. If the fish is solid purple with no yellow band, it is not a Royal Gramma. Verify before you buy.
Natural Habitat: Deep Caribbean Reefs and Ledges#
In the wild, Royal Grammas live across the western Atlantic and Caribbean — Bermuda south through the Bahamas, the Antilles, and the northern coast of South America. They occupy reef ledges, cave ceilings, and vertical wall faces between 10 and 200 feet deep. They are a deep-shade species, which is why they spawn so much time tucked under overhangs in the aquarium.
This deep, cave-oriented habitat explains two key behaviors. First, they prefer dimmer corners of the display tank over brightly lit open water. Second, they orient themselves relative to the nearest solid surface rather than to gravity, which is why a Royal Gramma swimming "upside down" along a cave ceiling is doing exactly what it does in the wild.
Average Size (3 inches) and Lifespan (5-6 years)#
Adult Royal Grammas top out at about 3 inches. Females and males are nearly identical in size and color, with males running slightly larger and developing longer pelvic fins as they mature. Captive lifespan is 5 to 6 years with stable water and a varied diet. Wild fish are estimated to live a similar span on the reef.
Water Parameters & Tank Requirements#
Royal Grammas are tolerant within the standard reef range. The numbers below are not aspirational — they are the working targets that produce healthy, long-lived fish.
Minimum Tank Size (30 Gallons) and Swimming Space#
A single Royal Gramma needs 30 gallons. Smaller tanks technically house the fish but give it nowhere to retreat when the dominant fish in the tank decides to assert territory. A 30-gallon footprint also gives you enough rockwork to build the cave structure these fish actually use.
For a pair (more on the difficulty of this below), step up to 75 gallons minimum. If you intend to mix the Royal Gramma with similarly shaped basslets or dottybacks, plan for 100+ gallons with distinct territorial zones broken up by tall rock pillars or sand-channel separators.
| Parameter | Target | Notes |
|---|---|---|
| Temperature | 72–78°F (22–26°C) | Stability matters more than the exact number |
| Salinity / SG | 1.020–1.025 | Use a refractometer, not a swing-arm hydrometer |
| pH | 8.1–8.4 | Standard reef range |
| Ammonia | 0 ppm | Any detectable level is toxic |
| Nitrite | 0 ppm | Must read zero before adding fish |
| Nitrate | <20 ppm | Weekly 10–15% water changes keep this in check |
| dKH (Alkalinity) | 8–12 dKH | Important if keeping corals alongside |
Ideal Parameters: 72-78°F, pH 8.1-8.4, Specific Gravity 1.020-1.025#
Aim for the middle of each range. A Royal Gramma in 75°F water at SG 1.024 will spend more time in the open and color up faster than one held at the edges of the tolerance range. Cycle the tank fully — ammonia and nitrite at zero for at least a full week — before introducing the fish.
Lighting and Rockwork: Providing Caves and Low-Light Retreats#
Royal Grammas need caves. Build at least three distinct overhangs or tunnels using stacked live rock, with at least one cave positioned where the fish can retreat into shade during peak lighting. PVC pipe works as a temporary cave, but live or dry reef rock is what these fish actually claim and defend long-term.
Lighting intensity is dictated by your corals, not your gramma. In a fish-only system, basic LED lighting at moderate output is enough. In a reef tank running high PAR for SPS corals, just make sure the rockwork creates shaded retreats so the fish can escape the light when it wants to.
Diet & Feeding#
Royal Grammas are zooplanktivores in the wild. They hover near reef ledges and pick small crustaceans out of the water column. In captivity, this translates to a straightforward carnivore diet that any aquarist can supply.
Carnivorous Needs: Mysis, Brine Shrimp, and High-Quality Pellets#
A working rotation:
- Frozen mysis shrimp — primary staple, fed 4 to 5 times per week
- Frozen enriched brine shrimp — alternated with mysis, 2 to 3 times per week
- High-quality marine pellets (New Life Spectrum, TDO Chroma Boost) — daily reinforcement
- Chopped krill or silversides — once a week as a treat
Feed small amounts 1 to 2 times per day. Each feeding should be consumed within 2 to 3 minutes. Royal Grammas are aggressive eaters and will dart out of their cave to grab food the moment it hits the water column — they rarely miss meals.
Vitamin Enrichment for Color Retention#
The magenta and yellow on a Royal Gramma will fade over time on a low-pigment diet. Soak frozen foods in a vitamin supplement (Selcon, Vita-Chem) once or twice per week. Foods with naturally high carotenoid content — krill, cyclops, copepods — also help maintain color. Faded color in an established fish almost always traces back to monotonous, unenriched feeding.
Tank Mates & Compatibility#
Royal Grammas are peaceful with the wider community but extremely territorial against their own kind and lookalikes. Plan tank mates around this single distinction.
Reef Safety: Why they are 100% Coral Safe#
Royal Grammas do not nip corals, do not eat copepods or amphipods at a rate that depletes the population, and do not bother ornamental shrimp or snails. They are one of the few marine fish that can be added to a delicate reef tank without any compatibility caveats. If your goal is a reef tank with peaceful fish that will not disturb your corals or inverts, the Royal Gramma is at the top of the list.
Keep one Royal Gramma per tank under 75 gallons. They will fight any other Royal Gramma, Black Cap Basslet, Royal Dottyback, or other purple/magenta basslet on sight, and the fight rarely ends until one fish is dead. The only exceptions are confirmed mated pairs, or simultaneous introduction of multiple specimens to a 100+ gallon tank with clearly separated territories.
Territorial Behavior with Other Basslets and Conspecifics#
Inside its claimed cave, a Royal Gramma will "gape" — opening its mouth wide as a threat display — at anything that approaches. This is normal and rarely escalates with unrelated tank mates. The behavior turns lethal only when the intruder is another gramma, dottyback, or similarly shaped purple fish.
If you want a second basslet of any kind in the same tank, plan the rockwork so the two fish cannot see each other from their respective territories. Sight breaks are the difference between coexistence and a dead fish.
Best Community Partners (Clownfish, Blennies, Gobies)#
Reliable Royal Gramma tank mates:
- Clownfish — captive-bred Ocellaris or Percula; same temperament class, no overlap in territory
- Tailspot blennies, midas blennies, lawnmower blennies — different niche (algae grazers), no conflict
- Watchman gobies, clown gobies, neon gobies — all peaceful, all compatible
- Cardinalfish (Banggai, pajama) — slow swimmers that ignore the gramma entirely
- Firefish (red, purple) — both peaceful, both reef-safe, both stay out of caves
Avoid in any tank under 75 gallons: other basslets, dottybacks (especially the Orchid Dottyback, which is more aggressive and similar in size), large angelfish, triggerfish, lionfish, and any predator that views a 3-inch fish as food.
Common Health Issues#
Royal Grammas are hardy, but they are not immune. The two diseases that account for most Royal Gramma losses are marine ich and bacterial infections from shipping stress.
Marine Ich (Cryptocaryon irritans) and Velvet#
Marine ich presents as small white spots on the body and fins, usually accompanied by flashing (rubbing against rocks) and increased respiration. Treat in a separate quarantine tank with copper-based medication at therapeutic levels. Never medicate a display reef — copper kills invertebrates, corals, and beneficial bacteria, and binds permanently to live rock.
Marine velvet (Amyloodinium ocellatum) is faster and more lethal — a fine gold-dust coating on the skin, rapid breathing, and death within 48 to 72 hours if untreated. Same treatment protocol as ich, but speed matters. Move suspected velvet cases to copper-treated quarantine the same day you spot symptoms.
Bacterial Infections from Shipping Stress#
Wild-caught Royal Grammas often arrive at the LFS already weakened from collection and transit. The most common shipping-related issue is mouth fungus (Flexibacter) — a cottony white growth around the mouth and head — followed by fin rot at the dorsal and caudal fins. Both progress quickly in a stressed fish.
Quarantine every new Royal Gramma for 2 to 4 weeks before adding to your display. Watch for: clamped fins, refusal of food after the third day, faded coloration, and any white film around the mouth. Catching bacterial infections in the first week of quarantine is the difference between treatment and a dead fish.
Where to Buy & What to Look For#
Royal Grammas are widely available at any saltwater-focused fish store. The challenge is sorting healthy specimens from shipping casualties — and avoiding the visually similar but behaviorally hostile Royal Dottyback.
Inspecting for "Flashing" or Rapid Breathing at the Store#
Before you buy, watch the tank for at least 5 minutes. A healthy Royal Gramma should be alert, holding position near a cave or ledge, with intact fins and clear eyes. Watch for:
- Flashing — the fish rubbing against rocks or sand. This signals parasites.
- Rapid gill movement — more than roughly 60 beats per minute at rest indicates stress, parasites, or velvet.
- Faded magenta — a healthy fish is electric purple, not lavender or gray.
- Hollow belly — the fish is starving or has internal parasites.
- White cottony patches around the mouth — early-stage Flexibacter. Walk away.
- Confirm it is a true Royal Gramma — sharp magenta-to-yellow color split, not solid purple
- Black eye stripe and black dorsal spot present (true Gramma loreto markers)
- No white cotton or fuzz around the mouth — rules out shipping-related Flexibacter
- Fins fully extended with no fraying, tears, or clamped posture
- Clear eyes with no cloudiness or popeye swelling
- Vivid magenta and bright yellow — no faded or gray patches
- Active in the tank, not parked motionless on the substrate
- Watch the store feed it before you commit — refusing food is a red flag
- No dead fish in the same system, and no visible spots on tank mates
Royal Grammas are widely available, but the difference between a healthy fish and a doomed one is how the store handled it. A dedicated saltwater LFS quarantines new arrivals for at least a week, lets staff feed and observe each fish, and will tell you the source. Big-box pet stores often pull the fish straight from shipping bags onto the sales floor, which is when bacterial infections start showing up three days later in your tank.
Why "Tank-Bred" is the Sustainable Choice#
The vast majority of Royal Grammas in the trade are wild-caught from the Caribbean. Captive-bred specimens exist but are still rare and command a premium. When available, captive-bred grammas are the better buy — they arrive disease-free, accept prepared foods on day one, and avoid the ecological footprint of wild collection.
If you can only find wild-caught (likely), prioritize stores that quarantine and that can tell you when the fish arrived. A Royal Gramma that has been at the LFS for 2 to 3 weeks and is actively eating is a much safer purchase than one that arrived yesterday.
Acclimation#
Use slow drip acclimation for Royal Grammas. They tolerate parameter changes better than most marine fish, but slow is still safer. Drip the bag water with display tank water at 2 to 3 drops per second for 60 to 90 minutes, then net the fish into the display (do not pour bag water in). Lights off for the first 24 hours. Expect the gramma to disappear into a cave for 2 to 7 days before it starts showing itself — this is normal, not a problem.
For a complete walkthrough, see our guide on setting up a saltwater aquarium and the broader saltwater fish overview for compatible species.
Quick-Reference Cheat Sheet#
Adult size: 3 inches
Lifespan: 5 to 6 years
Tank size: 30 gallons minimum (single specimen); 75+ gallons for a pair
Water parameters: 72-78°F, SG 1.020-1.025, pH 8.1-8.4, ammonia/nitrite 0 ppm, nitrate under 20 ppm
Diet: Carnivore — frozen mysis and brine shrimp, marine pellets, occasional krill. Vitamin-enriched 1-2x per week.
Reef safety: 100% reef-safe — no nipping at corals, no harm to inverts or shrimp
Tank mates: Clownfish, blennies, gobies, cardinalfish, firefish
Avoid: Other Royal Grammas, dottybacks, basslets in tanks under 75 gallons; large predators
Quarantine: 2 to 4 weeks before introducing to display
Disease watch: Marine ich (white spots), velvet (gold dust), Flexibacter (mouth fungus from shipping)
Lookalike to avoid: Royal Dottyback (Pseudochromis porphyreus) — solid purple, no yellow band, far more aggressive
Related species
Similar species you might also be considering for your tank.
Labroides dimidiatus
Acanthurus leucosternon
Pseudocheilinus hexataenia
Chromis viridis
Taeniura lymma
Acanthurus achilles