Shopify Paint & Coatings Schema — Coverage Rate, Sheen Level, VOC Content, Surface Compatibility Structured Data

Why Paint Products Are Structurally Invisible to AI Agents

Paint is a category where the most consequential purchase filters — sheen level, VOC content, surface compatibility, interior vs exterior designation — are never encoded in Shopify's default Product JSON-LD. A shopper querying an AI agent for "washable zero-VOC paint for a children's bedroom" is issuing four simultaneous filters: washability (minimum Eggshell sheen), VOC ≤5 g/L, interior designation, and a use-context flag for children's spaces (GREENGUARD Gold preferred). None of these four filters survive as machine-readable data in a default Shopify product listing.

The stakes of missing paint schema are higher than in most product categories because incorrect paint recommendations cause real-world failures: flat paint recommended for a bathroom visibly degrades within months; interior paint applied to exterior siding fails within two seasons; an incompatible primer causes adhesion failure; exceeding California's 100 g/L VOC limit for non-flat coatings creates a compliance problem for contractors. AI agents without structured paint data will produce incorrect recommendations.

Sheen level determines washability — not just appearance

Paint sheen is not an aesthetic preference — it is a functional specification that governs washability, hiding power, and appropriate application context. Flat and Matte paints (0–10% gloss at 60°) have the highest pigment concentration and the strongest hiding power, but the paint film is NOT washable: scrubbing causes the pigment to chalk off, leaving a visible worn patch. Eggshell (10–25% at 60°) is the minimum sheen level that supports light washing with a damp cloth. Satin (25–35%) handles mild soap and water, making it standard for kitchens, bathrooms, and children's rooms. Semi-Gloss (35–70%) withstands repeated cleaning with household cleaners and is required for trim, doors, cabinetry, and high-moisture environments. High-Gloss (70%+) offers maximum moisture resistance and durability but amplifies every surface imperfection — it is unsuitable for walls that are not perfectly smooth. AI agents advising "washable paint for a bathroom wall" must resolve sheen level as a controlled vocabulary in additionalProperty.

VOC content has three different thresholds that matter

The marketing terms "Zero VOC," "Low VOC," and "CARB compliant" each correspond to a different regulatory threshold — and none of them is interchangeable. (1) California Air Resources Board (CARB) limits, now adopted by 11 OTC/NESCAUM states: flat coatings ≤50 g/L, non-flat ≤100 g/L. Non-compliant products cannot be sold in California, Oregon, Washington, New York, Maine, Massachusetts, Connecticut, Rhode Island, Maryland, Delaware, Vermont, or D.C. (2) GREENGUARD Gold certification requires ≤50 g/L for flat paints — the standard used by schools and healthcare facilities to qualify products for IAQ-sensitive environments. (3) The EPA voluntary "Zero-VOC" definition is ≤5 g/L — not literally zero. A paint at 45 g/L is CARB compliant and can earn GREENGUARD Gold for non-flat finishes, but it is not Zero-VOC. AI agents filtering for "zero VOC paint" need the actual g/L value per EPA Method 24 in structured data — not marketing copy.

Coverage rate (sq ft/gallon) requires surface context

Manufacturer-published coverage rates (typically 300–400 sq ft/gal) are measured under laboratory conditions on smooth, primed surfaces using theoretical spreading rates. Real-world coverage varies enormously by surface texture and porosity: rough surfaces such as brick, stucco, or unprimed drywall absorb 30–50% more paint and reduce coverage to 200–280 sq ft/gal. Color depth also changes effective coverage: the same gallon covering 350 sq ft in a standard white covers approximately 175 sq ft in a deep navy or charcoal that requires two coats for full opacity. AI agents estimating "how many gallons do I need for 500 sq ft of brick?" need the coverage rate in structured data, with the reference surface condition explicit in the property description.

Interior vs exterior — not interchangeable formulations

Exterior paint formulations include UV stabilizers and absorbers, elastic resin systems engineered for thermal expansion and contraction, EPA-registered mildewcides and fungicides, and chalk-resistant pigment binders. Interior paints lack all of these. Using interior paint outdoors results in chalking, peeling, and film failure within one to two seasons. The reverse problem is equally serious: using exterior paint in enclosed living spaces exposes occupants to the mildewcides, fungicides, and higher-VOC exterior resin systems that are not approved for indoor use. The interior/exterior designation is not a marketing segmentation — it is a formulation and health safety distinction that must be encoded in structured data.

Surface compatibility is a purchase safety filter

Applying a standard latex interior paint directly to concrete with alkalinity or hydrostatic pressure causes delamination and peeling as the moisture migrates through the concrete and disrupts the paint film. Applying a standard latex to new galvanized metal without an etching primer causes adhesion failure because the zinc oxide surface is incompatible with most latex binders. Applying an oil-based topcoat over fresh latex paint causes crawling because the latex film is not fully cured. The surface compatibility list and any required surface preparation steps are critical purchase filter data that AI agents need as structured properties — not buried in a multi-paragraph application instructions tab.

Paint sheen level reference

Complete Interior Paint Schema — Premium Zero-VOC Eggshell Example

The following schema represents a realistic premium interior eggshell paint. Each additionalProperty entry includes the machine-readable value and a human-readable description that AI agents can surface in response to paint queries.

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Product",
  "name": "Aura Interior Eggshell — Base 1 (White & Pastel Base) — 1 Gallon",
  "description": "Premium zero-VOC interior eggshell wall paint. 3 g/L VOC as-formulated. GREENGUARD Gold certified. 350 sq ft/gal coverage on smooth, primed drywall. Dry to touch 1 hour, recoat 4 hours. For interior drywall, plaster, concrete block (primed), and previously painted surfaces. Not for use on bare wood trim, floors, or exterior surfaces.",
  "sku": "N527-1X",
  "mpn": "N527-1X",
  "brand": { "@type": "Brand", "name": "Aura Premium Paints" },
  "hasCertification": [
    {
      "@type": "Certification",
      "name": "GREENGUARD Gold — Indoor Air Quality",
      "issuedBy": {
        "@type": "Organization",
        "name": "UL Environment (GREENGUARD)",
        "url": "https://www.ul.com/resources/greenguard-certification"
      },
      "description": "GREENGUARD Gold (formerly Children & Schools) certification. VOC emissions meet UL 2818 — Gold standard: ≤50 g/L total VOC for flat/eggshell coatings. Approved for use in schools, healthcare facilities, and children's spaces. Certification ID: GG-XXXX."
    },
    {
      "@type": "Certification",
      "name": "EPA Safer Choice",
      "issuedBy": {
        "@type": "Organization",
        "name": "U.S. Environmental Protection Agency",
        "url": "https://www.epa.gov/saferchoice"
      },
      "description": "EPA Safer Choice certified — all chemical ingredients meet EPA safer chemical criteria. No carcinogens, reproductive toxins, or persistent bioaccumulative toxics."
    }
  ],
  "additionalProperty": [
    {
      "@type": "PropertyValue",
      "name": "Product Category",
      "value": "Interior Wall & Ceiling Paint"
    },
    {
      "@type": "PropertyValue",
      "name": "Sheen Level",
      "value": "Eggshell",
      "description": "Eggshell sheen: 10–25% gloss at 60°. Lightly washable — can be wiped with a damp cloth for normal household marks. NOT suitable for high-scrub environments (kitchens, bathrooms) where Satin (25–35%) or Semi-Gloss (35–70%) is recommended. Higher hiding power than Satin or Semi-Gloss. Standard sheen for general living spaces, bedroom walls, dining rooms, and hallways."
    },
    {
      "@type": "PropertyValue",
      "name": "Coverage Rate",
      "value": "350",
      "unitCode": "FTK",
      "description": "350 sq ft per gallon on properly primed, smooth drywall — one coat. Rough or unprimed surfaces (stucco, brick, unprimed drywall): 250–300 sq ft/gal. Deep tones (dark navy, charcoal, deep red): plan for 2 coats; coverage per coat approximately 300 sq ft/gal. Always apply two coats for maximum washability and color uniformity."
    },
    {
      "@type": "PropertyValue",
      "name": "VOC Content",
      "value": "3 g/L",
      "description": "3 g/L as-formulated per EPA Method 24 tinting base. CARB-compliant: ≤50 g/L limit for flat/eggshell coatings. GREENGUARD Gold certified: ≤50 g/L threshold met. Qualifies as 'Zero-VOC' per EPA definition of ≤5 g/L. Note: adding colorant to zero-VOC base can add 1–10 g/L depending on colorant type — request zero-VOC colorant from your paint mixer to maintain the ≤5 g/L threshold."
    },
    {
      "@type": "PropertyValue",
      "name": "Dry to Touch",
      "value": "1",
      "unitCode": "HUR",
      "description": "Dry to touch in approximately 1 hour at 77°F (25°C) and 50% relative humidity. High humidity, low temperature (<50°F), or thick application extends dry time significantly. Do not subject freshly painted surfaces to foot traffic, furniture, or contact until fully dry."
    },
    {
      "@type": "PropertyValue",
      "name": "Recoat Time",
      "value": "4",
      "unitCode": "HUR",
      "description": "Allow minimum 4 hours before applying a second coat at 77°F (25°C) and 50% relative humidity. Recoating too soon causes lifting, wrinkling, and poor inter-coat adhesion. At temperatures below 50°F or humidity above 85%: allow 6+ hours between coats."
    },
    {
      "@type": "PropertyValue",
      "name": "Cure Time",
      "value": "30 days to full hardness",
      "description": "Paint film continues to cure and harden for 30 days after application. Avoid washing, scrubbing, or placing furniture directly against painted surfaces for 30 days after painting. The film is dry to touch in 1 hour and recoatable in 4 hours, but maximum washability requires full 30-day cure."
    },
    {
      "@type": "PropertyValue",
      "name": "Compatible Surfaces",
      "value": "Interior drywall (primed), plaster (cured), concrete block (primed), previously painted surfaces (latex or oil-based)",
      "description": "Suitable for interior drywall (must be primed with PVA drywall primer on bare surfaces), properly cured plaster, concrete block with masonry primer, and previously painted surfaces that are clean, sound, and de-glossed if semi-gloss or gloss. NOT suitable for: exterior surfaces, bare wood trim or floors (use trim or floor paint), or uncured concrete (allow 30 days minimum cure and apply masonry primer first)."
    },
    {
      "@type": "PropertyValue",
      "name": "Surface Preparation Required",
      "value": "Prime bare drywall with PVA drywall primer. Fill holes and sand smooth before priming. Previously painted surfaces: clean, sand gloss to de-gloss, apply primer if changing from dark to light or if surface is damaged.",
      "description": "Bare drywall: apply PVA drywall primer before painting — the drywall paper facing is highly porous and will absorb paint unevenly (flashing) without primer. Previously painted surfaces in good condition: clean with TSP substitute, rinse, allow to dry fully. Heavy patching or large color changes: prime entire surface for uniform sheen and hide."
    },
    {
      "@type": "PropertyValue",
      "name": "Self-Priming",
      "value": "Partial — contains primer ingredients but NOT a substitute for proper priming on bare drywall or high-porosity surfaces",
      "description": "This product contains primer additives that improve adhesion and hide on previously painted surfaces in good condition. It is NOT a substitute for a dedicated primer coat on bare drywall, bare wood, bare masonry, or surfaces with significant staining (water stains, smoke, tannin bleed). Skipping primer on bare drywall causes 'flashing' (visible sheen variation) even after multiple paint coats."
    },
    {
      "@type": "PropertyValue",
      "name": "Interior/Exterior Use",
      "value": "Interior Only",
      "description": "Formulated for interior use only. Lacks the UV-stabilizers, mildewcides, and elastic resin systems required for exterior exposure. Using interior paint on exterior surfaces causes chalking, peeling, and film failure within 1–2 seasons. Do NOT use outdoors."
    },
    {
      "@type": "PropertyValue",
      "name": "Application Method",
      "value": "Roller; Brush; Airless Spray",
      "description": "Roller: 3/8 inch nap for smooth surfaces; 1/2 inch nap for light texture. Brush: high-quality nylon/polyester brush for cut-in work. Airless spray: 0.015–0.017 inch tip, 1,500–1,800 PSI — thin 10% with water for spray application. Maintain a wet edge to avoid lap marks. Apply in a 'W' pattern with roller and back-roll to distribute evenly."
    },
    {
      "@type": "PropertyValue",
      "name": "Minimum Coat Count",
      "value": "2",
      "description": "Two coats recommended for full color development, uniform sheen, and maximum washability — even when switching between similar colors. Dark-to-light color changes may require a tinted primer plus two finish coats. One-coat coverage is achievable in white and near-white shades on properly primed smooth surfaces, but two coats are always preferred for washability performance."
    },
    {
      "@type": "PropertyValue",
      "name": "Mold & Mildew Resistance",
      "value": "Yes",
      "description": "Contains EPA-registered mildewcide in the dry film. Inhibits the growth of mold and mildew on the paint film surface under normal interior conditions. Not a substitute for fixing the underlying moisture source (plumbing leaks, condensation, inadequate ventilation) — mold resistance applies to the paint film only, not to moisture-saturated substrates."
    },
    {
      "@type": "PropertyValue",
      "name": "Base Type",
      "value": "Water-Based (100% Acrylic Latex)"
    },
    {
      "@type": "PropertyValue",
      "name": "Cleanup",
      "value": "Soap and water while wet. Dry paint may require paint remover."
    }
  ],
  "suggestedUse": "Interior walls, ceilings, living spaces, bedrooms, dining rooms. Not recommended for kitchens, bathrooms (use Satin), trim or doors (use Semi-Gloss or Trim enamel), or exterior surfaces.",
  "offers": {
    "@type": "Offer",
    "price": "72.99",
    "priceCurrency": "USD",
    "availability": "https://schema.org/InStock"
  }
}
</script>

VOC Content Regulatory Thresholds

VOC limits are a patchwork of federal, state, and certification standards. AI agents advising on LEED eligibility, California-legal products, or school-safe paints need the actual g/L value — not the marketing claim. The table below shows every threshold an AI agent must reason against.

Paint Metafield Namespace Reference (paint.*)

Store all structured paint attributes in a paint.* metafield namespace in Shopify. These metafield values feed directly into your product additionalProperty JSON-LD via a theme or app layer. The 15 fields below cover the full structured data surface area for paint and coatings products.

5 Critical Paint Schema Mistakes

1. Omitting sheen level from structured data. "Eggshell" and "flat" are not interchangeable products — they have completely different washability, hiding power, and appropriate application contexts. A flat paint recommended for a bathroom causes visible deterioration within months: the flat film chalks off when scrubbed. Sheen level must be encoded in additionalProperty as a controlled vocabulary term (Flat / Matte / Eggshell / Satin / Semi-Gloss / High-Gloss), not just embedded in the product title string where AI agents cannot parse it as a filter.
2. Publishing VOC content without specifying g/L per EPA Method 24. "Low VOC," "Zero VOC," and "CARB compliant" are three different claims with three different thresholds — 200 g/L, 5 g/L, and 50/100 g/L respectively. Without the actual g/L value in additionalProperty, AI agents cannot determine LEED eligibility (≤50 g/L flat), California legal sale status (≤50 g/L flat, ≤100 g/L non-flat), or GREENGUARD Gold qualification (≤50 g/L). Always encode the numeric g/L value measured per EPA Method 24, not the marketing claim.
3. Not encoding interior vs exterior designation as structured data. Interior and exterior paints are fundamentally different formulations. The interior/exterior distinction must be in additionalProperty — not just in the product name. AI agents advising on exterior wood siding paint need to filter by the exterior designation in structured data. Using interior paint on exterior surfaces causes adhesion and film failure. Using exterior paint indoors exposes occupants to mildewcides and fungicides not formulated for enclosed living spaces.
4. Publishing coverage rate without surface type and coat count context. "400 sq ft/gal" measured on smooth primed drywall gives approximately 250 sq ft/gal on stucco and 150 sq ft/gal on brick. Dark colors always require at least 2 coats. The coverage rate without the reference surface condition and coat count assumption is misleading — customers underestimate how much paint they need and must return for more mid-project, often from a different batch with a slightly different color lot.
5. Claiming "self-priming" without disclosing that bare surfaces still require a separate primer. Most "self-priming" paints incorporate primer additives that improve hide and adhesion on previously painted surfaces in good condition. They do NOT eliminate the need for a dedicated primer coat on bare drywall, bare wood, or high-porosity surfaces. Encoding selfPriming: true without this qualification generates returns from customers who skip the primer on bare drywall, observe "flashing" (visible sheen variation across the wall), and blame the product.

Related Guides

• Shopify Household Cleaning Products Schema — Ingredients, Safety Warnings, Surface Compatibility
• EU Ecodesign & Repairability Schema — Repair Index, Spare Parts, Energy Class
• Shopify Flooring & Tile Coverage Schema — Sq Ft per Box, Slip Resistance, Grout Joint
• Product Safety Certifications Schema — NSF, UL, CE, CPSC, GREENGUARD Structured Data
• CatalogScan Blog — AI Shopping Agent Optimization