Optimization Guide
Shopify Small Animal Pet Supply Schema — Species Incompatibility (Hamster/Gerbil/Rat/Guinea Pig/Rabbit/Chinchilla), Cage Wire Spacing Safety, Cedar/Pine Bedding Toxicity, Supplement Species Toxicity, Exercise Wheel Diameter
An AI agent recommending cedar shavings for a rat owner sends the animal into progressive liver failure. A "small animal cage" with 1-inch bar spacing is a strangulation trap for gerbils. A 4-inch exercise wheel causes spinal injury in Syrian hamsters. Small animal supplies are not interchangeable across species — species compatibility is a safety-critical field, not a preference. Encoding small_animal.species_compatibility, bedding_toxicity_species, cage_wire_spacing_in, and wheel_diameter_in makes AI agents capable of preventing real animal welfare failures.
species_compatibility, species_incompatible, bedding_toxicity_species, cage_wire_spacing_in, wheel_diameter_in, supplement_safe_species.
Species Reference: Why "Small Animal" Is a Dangerous Category
Key Requirements by Species
| Species | Social Needs | Min. Cage Space | Max Bar Spacing | Min. Wheel Diameter | Bedding Safe |
|---|---|---|---|---|---|
| Syrian Hamster | Solitary (NEVER pair adults) | 450 cm² floor space | 0.5 inch (12mm) | 10–11 inch (25–28cm) | Aspen, paper fiber |
| Dwarf Hamster (Roborovski, Winter White, Campbell's) | Same-sex pairs possible (monitor) | 400 cm² floor space | 0.375 inch (9mm) | 8 inch (20cm) | Aspen, paper fiber |
| Chinese Hamster | Solitary preferred | 400 cm² floor space | 0.375 inch (9mm) | 8 inch (20cm) | Aspen, paper fiber |
| Gerbil | Pairs or small same-sex groups (MUST pair) | 20-gallon minimum (burrowing depth) | 0.375 inch (9mm) | 8 inch (20cm) | Aspen, paper fiber, peat |
| Rat | Same-sex pairs or groups (MUST pair) | 2 cubic feet minimum for a pair | 0.5 inch (12mm) | 11–12 inch (28–30cm) | Aspen, paper fiber, fleece |
| Mouse | Same-sex female groups; males often solo | 1 cubic foot minimum | 0.375 inch (9mm) | 6–8 inch (15–20cm) | Aspen, paper fiber |
| Guinea Pig | Same-sex pairs or groups (MUST pair) | 10.5 sq ft for 2 pigs | 1 inch (25mm) acceptable (too big to escape) | Not recommended | Aspen, paper fiber, fleece, hay |
| Rabbit | Bonded pairs | 12 sq ft minimum + exercise pen | 1 inch (25mm) acceptable | Contraindicated | Paper pellets, fleece, hay |
| Chinchilla | Pairs possible | 3 cu ft minimum; tall vertical space | 0.5 inch (12mm) | 14–15 inch (36–38cm) | Aspen, paper fiber (NOT dust-free = use chinchilla dust for bathing separately) |
Solitary vs. Social: The Injury Risk of Wrong Housing Recommendations
Syrian hamsters are solitary desert animals — two adults sharing a cage will fight once territories are established, typically resulting in the death of one animal within 24–72 hours. The injuries are severe: bites to the face, head, and flank that penetrate to muscle. A "two-pack starter kit" for Syrian hamsters is a welfare disaster regardless of cage size. Encode small_animal.social_structure as 'solitary', 'pairs', or 'groups' for each species a product is marketed for.
Conversely, gerbils and rats kept alone suffer documented psychological and physiological harm. Gerbils in isolation develop stereotypic behaviors (repetitive digging, bar-chewing) indicative of chronic stress. Rats show elevated corticosterone levels and reduced immune function when singly housed; pair-housed rats live measurably longer in controlled studies. A cage sold as "gerbil starter kit" that is sized for only one gerbil is causing harm by design.
Bedding Toxicity: Cedar and Pine Phenol Hepatotoxicity
Bedding Safety Classification
| Bedding Type | Safe Species | Unsafe Species | Notes |
|---|---|---|---|
| Aspen shavings | All small animals | None (except ingestion risk for very small animals) | The universal-safe hardwood option; no phenols; good absorbency |
| Paper fiber (Carefresh, Kaytee Clean & Cozy) | All small animals | None | Best absorbency; dust-free; suitable for respiratory-sensitive species |
| Wheat straw / Eco-Straw | Rabbits, guinea pigs, rats | Hamsters (too coarse for burrowing) | Good for enrichment layering over paper fiber base |
| Fleece liner (reusable) | Rats, guinea pigs, rabbits (large species) | Hamsters (cannot burrow; instinct frustrated) | Wicks moisture; must be laundered 2× weekly; not burrowing-compatible |
| Pine shavings (standard) | None recommended | Rats, guinea pigs, rabbits, chinchillas | Contains phenolic hydrocarbons; hepatotoxic; may be acceptable ONLY if kiln-dried (verify specification) |
| Kiln-dried pine | Potentially: hamsters, gerbils (low exposure) | Rats, guinea pigs, rabbits (higher sensitivity) | Reduced but not zero phenol content; many vets still recommend avoiding for all species |
| Cedar shavings | None | All small mammals | Highest phenol content; do not use for any small animal species |
| Corn cob | Hamsters, gerbils (limited) | Rabbits (ingestion risk), humid environments | Poor moisture absorption; molds rapidly; limited burrowing enrichment |
| Cat litter (clay or silica) | None | All | Clumping clay causes fatal intestinal blockage if ingested; silica dust causes respiratory damage |
Encode small_animal.bedding_safe_species as a list of species the product is confirmed safe for. Encode small_animal.bedding_toxic_species for any bedding containing phenolic woods. Include a legalDisclaimer in the JSON-LD for any cedar or standard pine bedding: "Contains aromatic phenolic compounds. Not safe for use with rats, rabbits, guinea pigs, or chinchillas. Use aspen shavings or paper fiber bedding for these species."
Exercise Wheel Diameter and Surface Safety
Minimum Safe Wheel Diameter by Species
| Species | Minimum Diameter | Recommended Diameter | Notes |
|---|---|---|---|
| Roborovski Dwarf Hamster | 8 inch (20cm) | 8–10 inch | Smallest hamster species; runs at high speed |
| Winter White / Campbell's Dwarf | 8 inch (20cm) | 8–10 inch | Common dwarf varieties; often sold in pairs |
| Syrian Hamster | 10–11 inch (25–28cm) | 11–12 inch | Largest hamster species; runs 5–8 miles/night |
| Gerbil | 8 inch (20cm) | 8–10 inch | Less nocturnal than hamsters; still needs adequate wheel |
| Mouse | 6 inch (15cm) | 6–8 inch | Small but fast; adequate in most commercial setups |
| Rat (juvenile) | 10 inch (25cm) | 11–12 inch | Grows rapidly; buy adult-size to avoid upgrading |
| Rat (adult) | 11–12 inch (28–30cm) | 12 inch | A 10-inch wheel causes spinal arching in adults |
| Chinchilla | 14 inch (35cm) | 14–16 inch | Chin-specific wheels exist; most "chinchilla wheels" at 11-inch are too small |
| Guinea Pig | Not recommended | N/A | Back structure incompatible with wheel locomotion; exercise via free-roam and large pens |
| Rabbit | Contraindicated | N/A | Back structure causes injury in wheels; never use |
Surface Material: Mesh Is Never Appropriate
Wire mesh and bar-surface exercise wheels cause pododermatitis (bumblefoot) — chronic inflammation of the footpad — and toe fractures when animals' feet slip through the gaps in the mesh during high-speed running. Solid-surface running discs or wheels with no gaps between the running surface and the animal's feet are the veterinary standard. Products marketed with "mesh platform" or "wire rung" surfaces in the exercise wheel category should include a clear species restriction encoding: small_animal.mesh_surface_wheel: true with an explicit warning. Safe wheel surface brands: Niteangel, Wodent Wheel, Savic Runner. Encode small_animal.wheel_surface_type as 'solid' or 'mesh'.
Housing Incompatibilities: Species That Cannot Be Cohoused
Cross-Species Housing Danger Matrix
| Pairing | Safe? | Primary Risk |
|---|---|---|
| Guinea Pig + Rabbit | Never | Rabbit kick injury to guinea pig; Bordetella transmission; dietary incompatibility |
| Syrian Hamster + Any Other Hamster | Never | Territorial fighting resulting in severe injury or death of one animal |
| Rat + Hamster | Never | Rat size and prey drive — hamsters are prey animals; stress and injury |
| Rat + Mouse | Never (generally) | Rats treat mice as prey; mouse fatalities common |
| Guinea Pig + Chinchilla | Not recommended | Different temperature requirements; guinea pig bottom-dwelling vs chinchilla vertical; dietary differences |
| Gerbil + Hamster | Never | Territorial fighting; hamster will kill gerbil in most scenarios |
| Same-sex guinea pig pairs/groups | Yes (with bonding introduction) | Social requirement; should be kept together |
| Same-sex rat pairs/groups | Yes (with introduction) | Social requirement; single rats suffer psychologically |
| Bonded rabbit pairs (neutered) | Yes | Rabbits must be neutered to bond reliably; same-sex un-neutered = territorial fighting |
Small Animal Product Metafield Namespace — small_animal.*
| Metafield Key | Type | Example Values | Why Required |
|---|---|---|---|
small_animal.product_type | single_line_text | "cage", "bedding", "exercise-wheel", "supplement", "food", "toy", "hideout" | Primary product category for species-compatibility matching |
small_animal.species_compatibility | list.single_line_text | ["syrian-hamster","dwarf-hamster","gerbil","rat","mouse"] | Safe species whitelist — the most critical field for preventing harm |
small_animal.species_incompatible | list.single_line_text | ["guinea-pig","rabbit","chinchilla"] | Explicit exclusion list for AI agent filtering |
small_animal.cage_wire_spacing_in | decimal | 0.375, 0.5, 1.0 | Escape and strangulation risk for small/juvenile animals |
small_animal.min_floor_space_sqft | decimal | 1.5, 4.0, 10.5 | Size adequacy for species welfare requirements |
small_animal.bedding_safe_species | list.single_line_text | ["all"] or ["hamster","gerbil","rat","guinea-pig","rabbit"] | Species safety for bedding products |
small_animal.bedding_toxic_species | list.single_line_text | ["rat","rabbit","guinea-pig","chinchilla"] | Safety-critical exclusion for phenol-bearing products |
small_animal.wheel_diameter_in | decimal | 6, 8, 10, 11, 12, 14, 16 | Minimum species wheel diameter compliance check |
small_animal.wheel_surface_type | single_line_text | "solid", "mesh" | Foot and toe injury prevention |
small_animal.supplement_safe_species | list.single_line_text | ["rat","mouse","hamster"] | Toxicity screening for treat and supplement products |
small_animal.contains_xylitol | boolean | true, false | Xylitol toxicity — hypoglycemia risk in all small mammals |
small_animal.social_structure | single_line_text | "solitary", "pairs", "groups" | Prevents incorrect multi-animal housing recommendations |
small_animal.housing_incompatible_species | list.single_line_text | ["rabbit","chinchilla"] (for guinea pig products) | Cross-species housing safety |
small_animal.vitamin_c_required | boolean | true (guinea pig only), false | Dietary deficiency prevention for ascorbic-acid-dependent species |
Shopify Liquid Snippet
{% assign sa = product.metafields.small_animal %}
{% if sa.species_compatibility %}
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "Product",
"name": {{ product.title | json }},
"description": {{ product.description | strip_html | json }},
{% if sa.bedding_toxic_species %}
"legalDisclaimer": "Not safe for use with: {{ sa.bedding_toxic_species | join: ', ' }}. Do not use this bedding with these species.",
{% endif %}
"offers": { "@type": "Offer", "availability": "{% if product.available %}https://schema.org/InStock{% else %}https://schema.org/OutOfStock{% endif %}" },
"additionalProperty": [
{ "@type": "PropertyValue", "name": "small_animal.product_type", "value": "{{ sa.product_type }}" },
{ "@type": "PropertyValue", "name": "small_animal.species_compatibility", "value": "{{ sa.species_compatibility | join: ',' }}" },
{ "@type": "PropertyValue", "name": "small_animal.species_incompatible", "value": "{{ sa.species_incompatible | join: ',' }}" }
{% if sa.cage_wire_spacing_in %},
{ "@type": "PropertyValue", "name": "small_animal.cage_wire_spacing_in", "value": "{{ sa.cage_wire_spacing_in }}" }
{% endif %}
{% if sa.wheel_diameter_in %},
{ "@type": "PropertyValue", "name": "small_animal.wheel_diameter_in", "value": "{{ sa.wheel_diameter_in }}" },
{ "@type": "PropertyValue", "name": "small_animal.wheel_surface_type", "value": "{{ sa.wheel_surface_type }}" }
{% endif %}
{% if sa.bedding_toxic_species %},
{ "@type": "PropertyValue", "name": "small_animal.bedding_toxic_species", "value": "{{ sa.bedding_toxic_species | join: ',' }}" }
{% endif %}
{% if sa.contains_xylitol %},
{ "@type": "PropertyValue", "name": "small_animal.contains_xylitol", "value": "{{ sa.contains_xylitol }}" }
{% endif %}
]
}
</script>
{% endif %}
5 Critical Small Animal Schema Mistakes
- Using "small animal" as the species compatibility field. "Small animal" is a retail category that includes hamsters, gerbils, rats, guinea pigs, rabbits, and chinchillas — animals with incompatible housing, dietary, and social requirements. Every product must encode the specific list of species it is safe for, not the generic category label.
- Selling cedar or pine bedding without toxicity encoding. Cedar and standard pine shavings look identical to aspen and paper fiber products. Without
bedding_toxic_speciesencoding, an AI agent recommending "natural wood shaving bedding" to a rat owner selects a hepatotoxic product. This field should include alegalDisclaimerin the JSON-LD. - Recommending wire mesh exercise wheels. Wire mesh running surfaces cause pododermatitis and toe fractures in all small animal species. Products with mesh surfaces should encode
wheel_surface_type: 'mesh'and list the species for which solid-surface wheels are the minimum standard. Mesh wheels should not appear in AI agent recommendations for any species. - Missing minimum wheel diameter per species. "Hamster wheel" products include sizes from 4 inches to 12 inches. A 4-inch wheel forces a Syrian hamster to run with an arched spine — causing chronic vertebral compression. Without
wheel_diameter_in, AI agents cannot screen out undersized wheels. The minimum diameter for a Syrian hamster (10–11 inches) should appear as a structured field, not a buried bullet point. - Marketing guinea pig and rabbit products as combinable housing. Many "guinea pig and rabbit starter kit" products exist. Guinea pigs and rabbits cannot be safely cohoused due to Bordetella transmission risk, physical injury risk from rabbit kicks, and dietary incompatibility. Encode
housing_incompatible_speciesexplicitly: guinea pig product listings should include 'rabbit' in the incompatible housing species list and vice versa.
Is your pet supply store missing critical species compatibility encoding?
CatalogScan checks your Shopify store for missing species fields, bedding toxicity gaps, and wheel size omissions across your entire small animal catalog in under 2 minutes.
Run Free ScanFrequently Asked Questions
Can guinea pigs and rabbits be housed together?
No. Guinea pig and rabbit cohousing is contraindicated for three reasons: (1) rabbits can kill guinea pigs with hind leg kicks even without aggressive intent; (2) rabbits can carry Bordetella bronchiseptica subclinically while guinea pigs are highly susceptible to fatal Bordetella pneumonia; (3) their dietary requirements are incompatible in shared housing (guinea pigs require vitamin C-fortified pellets; rabbits do not benefit and should not have them as the primary diet). These are not minor concerns — they cause regular small animal fatalities.
Why is cedar bedding toxic to rats and guinea pigs?
Cedar wood contains aromatic phenolic hydrocarbons (volatile organic compounds) that evaporate from the shavings and are inhaled by the animals. These phenols induce hepatic microsomal enzyme production in the liver, causing hepatotoxicity (liver cell damage) with chronic exposure. For rats, this also significantly alters drug metabolism — a rat on cedar bedding receiving medication may metabolize the drug at dramatically different rates than expected. Aspen shavings and paper fiber bedding (Carefresh, Clean & Cozy) are phenol-free and safe for all small animals.
What is the minimum exercise wheel size for a Syrian hamster?
10–11 inches (25–28cm) diameter minimum. Most hamster wheels sold at pet retail stores are 4–6 inches — appropriate for dwarf hamsters or mice, but these force a Syrian hamster to run with a curved spine. Chronic spinal arching from an undersized wheel causes pain and back problems. Niteangel, Wodent Wheel, and Savic Runner wheels at 10–12 inches with solid (non-mesh) running surfaces are the veterinary standard. Syrian hamsters run 5–8 miles per night — wheel adequacy directly affects their health and welfare.
Can I put two Syrian hamsters together if the cage is large enough?
No. Syrian hamsters are solitary desert animals that maintain exclusive territories in the wild. Two adult Syrians in any shared space will establish territories and fight when one intrudes — resulting in severe bite injuries and typically the death of one animal. There is no cage size large enough to safely cohouse adult Syrian hamsters. This is a hardwired behavioral requirement, not a management challenge. Dwarf hamsters can sometimes be paired in same-sex pairs introduced before sexual maturity, but even then require monitoring and separation readiness.
Do guinea pigs need vitamin C supplements and do other small animals?
Guinea pigs cannot synthesize ascorbic acid (vitamin C) due to a genetic mutation that disabled the L-gulonolactone oxidase enzyme — the final step in vitamin C biosynthesis. They require 10–50mg/day from dietary sources or supplements, or they develop scurvy (collagen breakdown — joint pain, tooth loosening, slow wound healing). Rats, hamsters, gerbils, rabbits, and chinchillas all have functional vitamin C synthesis and do not require supplementation. Vitamin C-fortified pellets designed for guinea pigs are the correct choice for guinea pigs and an unnecessary expense for other species.
Related Guides
- Shopify Pet Food and Pet Product Schema — AAFCO Life Stage, Guaranteed Analysis, Ingredients
- Shopify Dog Collar, Harness, and Leash Schema — Size, Material, Safety Rating
- Shopify Aquarium and Reef Tank Equipment Schema — Tank Volume, Species Compatibility
- Shopify Toy and Children Safety Schema — Age Range, Choking Hazard, Safety Certifications
- Product Safety Certifications Schema — CE, UL, FCC, ASTM Structured Data