---

title: "Royal Gramma: The Complete Reef Care Guide & Tank Setup" description: "The definitive royal gramma (Gramma loreto) care guide: reef tank setup, water parameters, feeding, cave territory, the royal gramma vs dottyback question, and tank mates." slug: royal-gramma commonName: Royal Gramma scientificName: Gramma loreto family: Grammatidae order: Perciformes difficulty: Beginner minTankSize: 30 temperature: "72–80°F (22–27°C)" ph: "8.0–8.4" hardness: "Marine — SG 1.020–1.026" lifespan: "5–6 years" maxSize: "3 inches (8 cm)" origin: "Caribbean, Western Atlantic" publishedAt: "2026-06-04"

Royal Gramma: The Complete Reef Care Guide & Tank Setup

Few marine fish deliver as much colour for as little effort as the royal gramma. A small Caribbean basslet shading from electric purple at the head to brilliant gold at the tail, it is hardy, inexpensive, reef-safe, peaceful, and bold enough to display in the open — a near-perfect beginner marine fish. Its one quirk, defending a favourite cave with surprising fierceness, is easily accommodated with good aquascaping, and its habit of hovering upside-down beneath ledges only adds to its charm.

This guide is the complete reference: the gramma's natural history and unusual cave-oriented behaviour, exactly how to set up its reef home, what to feed it, how to tell it from the look-alike royal dottyback (and why you shouldn't keep both), and how it breeds.

---

Species Overview

The royal gramma (Gramma loreto) is a small basslet in the family Grammatidae, native to the reefs of the Caribbean and western Atlantic. It reaches only about 8 cm (3 inches) and is famous for its colour gradient — the front half a vivid violet-purple, transitioning through a striking mid-body blend to a golden-yellow rear, with a small black spot on the front of the dorsal fin and a fine dark line through the eye. The colour split is so clean it looks painted.

The royal gramma's appeal goes beyond looks. It is hardy and disease-resistant, inexpensive and widely available, and reef-safe — no threat to corals or invertebrates. It is also bold for a small fish, hovering in the open near its cave rather than hiding, which means you actually see it. Its only behavioural wrinkle is a strong attachment to a chosen cave or ledge, which it defends against intruders, particularly similar-looking fish. With good care it lives 5–6 years.

A charming quirk: royal grammas orient their bodies to the nearest surface, so under an overhang or in a cave they often hover upside-down or sideways, belly toward the rock — a behaviour that alarms new keepers but is completely normal.

---

Natural History and Origin

Gramma loreto comes from the coral reefs of the Caribbean and tropical western Atlantic — Florida, the Bahamas, the Antilles, and down to Venezuela — where it lives on reef walls, ledges, caves, and overhangs, typically at moderate depths in dimmer, shaded reef structure rather than the bright open reef top. This is the origin of its cave-loving, surface-orienting behaviour: in the wild it lives its life around a specific crevice, darting out to snatch zooplankton drifting past and retreating to shelter.

Royal grammas are zooplanktivores in the wild, picking copepods and other small drifting prey from the water column and grazing tiny crustaceans from the rock. They also act as occasional cleaner fish when young, picking parasites from larger fish. Their natural habitat — shaded, structured, food-rich reef walls — translates directly into their aquarium needs: plenty of rockwork with caves and ledges, and a varied meaty diet.

---

Water Parameters

Royal grammas are forgiving by marine standards, but as with all reef fish, stability matters more than chasing perfect numbers.

Mix salt with RO/DI water, target your salinity with a refractometer, and add the gramma only to a fully cycled, mature tank — confirm with the nitrogen cycle tracker and keep parameters dialled in with the water parameters reference. A royal gramma added too early, to an unstable tank, is far more likely to hide and decline.

---

Tank Setup Guide

The single most important setup consideration for a royal gramma is rockwork with caves — give it a home it can claim and it will reward you by displaying boldly.

Tank size

A minimum of 30 gallons (115 litres) gives a royal gramma room to establish a territory and reduces conflict with tank mates. While it is a small fish, a too-small or sparsely-decorated tank leads to a shy, stressed gramma or to territorial squabbles. 30+ gallons of well-aquascaped reef is ideal.

Live rock and caves — essential

Build an open, stable aquascape of live rock with plenty of caves, crevices, ledges, and overhangs. The gramma needs a cave it can adopt as home base and bolt-hole; without one it never settles. More structure also breaks sightlines and reduces territorial aggression in a community. This is the decor decision that makes or breaks royal gramma keeping.

Filtration, flow, sand, and lighting

Run a standard reef setup — live rock for biological filtration, a protein skimmer, moderate flow, and a shallow aragonite sand bed. Lighting is flexible: grammas don't care, so light to suit your corals. Because grammas come from shaded reef walls, they appreciate some dimmer, structured areas to retreat into.

Lid — important

Royal grammas are notorious jumpers, especially when first added or when squabbling over territory. A secure lid or mesh screen top is essential — jumping is the most common way keepers lose them.

---

Feeding Guide

Royal grammas are carnivorous zooplanktivores and are easy to feed once settled, readily accepting prepared and frozen foods.

What to feed

• Frozen mysis shrimp — an excellent staple that suits their natural prey size and brings out colour.
• Enriched frozen brine shrimp — a good supplement.
• Marine pellets and flakes — most grammas take quality prepared foods readily once acclimated.
• Copepods and other small live foods — superb enrichment that mirrors their natural diet of drifting zooplankton.

How often

Feed two to three small meals daily, offering only what's eaten quickly. A newly added gramma may be shy and feed from the safety of its cave at first; offering food near its hideout helps it settle. A well-fed royal gramma is vividly coloured and bold; pale colour or persistent hiding usually points to stress, poor water, or aggression from tank mates.

---

Behavior and Temperament

Royal grammas occupy an appealing middle ground — peaceful toward most tank mates but boldly territorial about their cave. Day to day, a settled gramma hovers near its chosen crevice, darting out to feed and retreating when startled, and frequently orienting belly-to-the-rock so it appears to hover upside-down under ledges. This surface-orienting habit is normal and one of the species' charms.

Toward unrelated reef fish the gramma is generally a good citizen. The friction comes with similar-looking or similarly-behaved fish — especially other grammas, basslets, and the look-alike royal dottyback — which it perceives as rivals for its cave. In a well-aquascaped tank with multiple caves and good sightline breaks, a single royal gramma is a peaceful, colourful community member. It also won't bother corals or inverts, making it a true reef-safe fish.

---

Royal Gramma vs Royal Dottyback

These two are constantly confused, and the confusion causes real tank conflict, so it's worth being clear.

The quickest tell is the colour boundary: the gramma's purple fades smoothly into gold, while the dottyback's colours meet at a sharp line. Critically, do not keep the two together — they look like rivals to each other and the more aggressive dottyback will harass the gramma. Choose one or the other.

---

Compatibility

Royal grammas are excellent peaceful community reef fish, with a few sensible cautions around their territoriality.

Good tank mates: percula and ocellaris clownfish, firefish goby, neon goby, banggai cardinalfish, green chromis, yellow watchman goby, tangs, and most peaceful-to-semi-aggressive reef fish.

Cautions and conflicts:

• Other royal grammas — keep only one per typical tank (a mated pair or a group works only in a large tank with many caves).
• Royal dottyback and other basslets — avoid; they're seen as rivals.
• Large predators — lionfish, large groupers, and eels may eat a small gramma.

The recipe for harmony is simple: one royal gramma, plenty of caves, peaceful tank mates, and no look-alikes. Use the compatibility checker to plan your stocking.

---

Breeding Guide

Royal grammas do spawn in the home aquarium, though raising the larvae is challenging. A male will build a nest in a crevice, lining it with bits of algae and substrate, and entice a female to lay eggs there, which he then guards and tends. Spawning can occur repeatedly, often around dusk.

The difficulty is in rearing the pelagic larvae, which are tiny and require live rotifers and copepods, dim stable conditions, and meticulous water quality over a relatively long larval period — a project for advanced marine breeders rather than beginners. Still, witnessing nesting and spawning behaviour in a display tank is a rewarding sign of a healthy, well-kept pair, even if the larvae aren't reared.

---

Health and Disease

Royal grammas are hardy, and most problems are the standard marine parasites and stress-related issues, all reduced by quarantine and stability.

Marine ich (Cryptocaryon) — white spots, flashing, rapid breathing — is the most common parasite; treat in quarantine with copper or other appropriate therapy. Marine velvet (Amyloodinium) is a faster, deadlier dusting-and-gasping disease requiring emergency quarantine treatment. Bacterial infections and fin damage follow poor water, injury, or bullying. A shy gramma that won't leave its cave and stops eating is often being harassed or kept in an unstable tank.

Prevention is the same as for all marine fish: quarantine new arrivals, keep parameters rock-stable, feed a varied vitamin-rich diet, provide ample caves so the gramma feels secure, and a secure lid to prevent jumping. Given those, the royal gramma is one of the most trouble-free marine fish in the hobby.

---

Interesting Facts

• It hovers upside-down. Royal grammas orient to the nearest surface, so under ledges and in caves they hover belly-to-the-rock, appearing inverted — perfectly normal behaviour.
• A part-time cleaner. Juvenile royal grammas sometimes act as cleaner fish, picking parasites from larger reef fish.
• A two-tone illusion. The purple-to-gold gradient is so clean the fish can look like two halves stuck together — distinguishing it from the hard-edged dottyback.
• Caribbean native. Unlike most aquarium marine fish (which come from the Indo-Pacific), the royal gramma is an Atlantic/Caribbean species.
• Nest builder. Males construct and tend nests in rock crevices, an unusually involved parental behaviour for a small reef fish.

---

Bringing It Together

The royal gramma is one of the best first marine fish you can choose: dazzlingly colourful, hardy, inexpensive, reef-safe, and bold enough to actually display itself. Give it a 30-gallon-plus reef with plenty of live-rock caves to claim, stable marine parameters, a varied meaty diet built on mysis, and a secure lid against jumping — and keep it as the only gramma, away from the look-alike royal dottyback — and it will hover proudly by its cave for years. Plan the aquascape and stocking with the AI Tank Blueprint generator and the compatibility checker, and pair it with peaceful reef mates like the percula clownfish, firefish goby, and banggai cardinalfish for a vibrant, harmonious community.