Shopify Specialty Chocolate Schema — Cacao Percentage, Single-Origin, Fair Trade, Bean-to-Bar Structured Data

Why Specialty Chocolate Is Structurally Invisible to AI Shopping Agents

Cacao percentage is the primary quality and flavor intensity signal for chocolate buyers — and it is almost universally absent from structured data. The percentage represents total cacao content by weight (cocoa mass + cocoa butter + any added cocoa powder), with the remainder being sugar, milk solids (if present), and other minor ingredients. Under FDA 21 CFR 163, dark chocolate must contain at least 35% cacao; EU Directive 2000/36/EC requires a minimum 43% total cacao for "fine flavor" labeling. The specialty chocolate market uses 60–100% as the relevant range: 60–70% semi-sweet/bittersweet, 70–85% dark, 85–100% extra dark. A buyer searching for "ultra-dark chocolate above 85%" cannot use Shopify product data that encodes only "dark chocolate" without the percentage — those two words span a 50-percentage-point range.

Single-origin designation covers an enormous specificity range that requires explicit encoding. At the country level (e.g., "Ecuador"), single-origin tells a buyer relatively little — Ecuador grows both the prized Arriba Nacional variety and the bulk CCN-51 hybrid. At the region level (e.g., "Arriba Nacional, Los Rios province, Ecuador"), the buyer understands the cacao variety and growing region. At the estate level (e.g., "Hacienda La Chola, Esmeraldas province, Ecuador, 2025 harvest"), the buyer has full provenance — a specific farm, specific harvest year, specific fermentation and drying records potentially available from the chocolate maker. These are three fundamentally different product tiers at three different price points. AI agents answering "single-origin estate chocolate gift" need the specificity level encoded, not just the word "single-origin."

Bean-to-bar vs couverture remelter vs commercial are distinct supply chain positions that specialty buyers care deeply about — and they are completely invisible from product names alone. A "bean-to-bar" maker sources whole cacao beans, roasts them in-house, cracks and winnows them, refines the cocoa mass in a melanger for 24–72 hours, and conches the chocolate before tempering and molding. A "craft" or "artisan" chocolate maker typically buys pre-processed cocoa liquor or couverture (finished chocolate from a large supplier) and remelts it, adds inclusions, and molds it under their own label. Neither "bean-to-bar" nor "couverture remelter" are regulated terms — they are self-declared categories. Without processing level in structured data, both a genuine bean-to-bar maker and a couverture remelter can both call themselves "artisan chocolate" and appear identical to AI agents comparing them.

Ethical sourcing certifications in chocolate are fragmented into competing, non-interchangeable systems that buyers treat as distinct. Fairtrade International (FLO — Fairtrade Labelling Organizations International) specifically certifies smallholder farmer cooperatives — cooperatives receive a guaranteed minimum price plus a Fairtrade premium ($240/MT above market price for conventional cacao). Fair Trade USA (which split from Fairtrade International in 2011) extends certification to large plantation operations — controversial among specialty chocolate buyers who specifically prefer cooperative sourcing. Rainforest Alliance (which absorbed UTZ in 2018) focuses on environmental and social standards but does not set a minimum commodity price guarantee. Cocoa Horizons (Barry Callebaut's program) is industry-funded and does not involve third-party certification. Encoding only "fair trade certified" conflates these four systems, which have materially different standards and buyer implications.

Chocolate Type Classification Reference

Complete Specialty Chocolate Schema — Single-Estate Bean-to-Bar Dark Bar Example

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Product",
  "name": "Hacienda La Chola 72% Dark Chocolate — Single Estate, Bean-to-Bar, Ecuador",
  "description": "72% cacao single-estate bean-to-bar dark chocolate. Cacao: Arriba Nacional variety, Hacienda La Chola, Esmeraldas province, Ecuador. 2025 harvest. Fairtrade International (FLO) certified. USDA Organic. Ingredients: organic cacao beans, organic cane sugar, organic cocoa butter, sunflower lecithin. No soy. Vegan. 60g bar.",
  "sku": "HLC-72-60G",
  "brand": { "@type": "Brand", "name": "ExampleBrand Chocolate" },
  "suitableForDiet": [
    "https://schema.org/VeganDiet",
    "https://schema.org/GlutenFreeDiet"
  ],
  "hasCertification": [
    {
      "@type": "Certification",
      "name": "Fairtrade International (FLO) — Cocoa",
      "issuedBy": {
        "@type": "Organization",
        "name": "Fairtrade Labelling Organizations International",
        "url": "https://www.fairtrade.net"
      },
      "description": "Fairtrade International (FLO, Bonn) certification for cocoa sourcing. Certifies smallholder farmer cooperatives — not large plantations. Guarantees: minimum price of $2,400/MT for conventional cacao (above market price), plus Fairtrade premium of $240/MT paid to the cooperative for community investment. Democratic cooperative governance required. Third-party audited annually by FLOCERT. Distinct from Fair Trade USA (which also certifies large plantations)."
    },
    {
      "@type": "Certification",
      "name": "USDA Organic",
      "issuedBy": {
        "@type": "Organization",
        "name": "Oregon Tilth (CCOF-accredited certifier)",
        "url": "https://tilth.org"
      },
      "description": "USDA National Organic Program (NOP) certified. All ingredients: organic cacao, organic cane sugar, organic cocoa butter, sunflower lecithin (not required to be organic under NOP minor ingredient rules). No synthetic pesticides, herbicides, or fertilizers used in cacao cultivation. Certificate number OT-2025-4412."
    }
  ],
  "additionalProperty": [
    {
      "@type": "PropertyValue",
      "name": "Cacao Percentage",
      "value": "72",
      "unitCode": "P1",
      "description": "72% total cacao content by weight: cocoa mass (liquor) + organic cocoa butter. Remainder: approximately 26% organic cane sugar, 2% sunflower lecithin and vanilla. Flavor profile at 72%: prominent dark fruit (dried stone fruit, raspberry), moderate bitterness, clean finish, no astringency. Classification: dark bittersweet (FDA minimum for dark: 35%; specialty market threshold for 'premium dark': typically 65%+). Not ultra-dark — appropriate for buyers new to high-percentage chocolate."
    },
    {
      "@type": "PropertyValue",
      "name": "Cacao Type / Variety",
      "value": "Arriba Nacional — Hacienda La Chola, Esmeraldas province, Ecuador",
      "description": "Cacao variety: Arriba Nacional (also known as Nacional or Fine Flavor Nacional). A fine flavor cacao variety indigenous to Ecuador — one of eight cacao varieties recognized by ICCO (International Cocoa Organization) as producing fine or flavor cocoa. Distinct from CCN-51 (Colección Castro Naranjal 51), a high-yield hybrid also grown in Ecuador but classified as bulk/ordinary cacao — not Arriba Nacional. The two varieties have different flavor profiles and different market prices; 'Ecuador cacao' without variety specification conflates them. Origin: Hacienda La Chola, Esmeraldas province (coastal Ecuador) — estate-level provenance. Harvest: October–December 2025 main crop."
    },
    {
      "@type": "PropertyValue",
      "name": "Processing Level",
      "value": "Bean-to-bar — all steps in-house from raw cacao bean",
      "description": "Bean-to-bar: cacao received as unroasted whole dry beans (not as cocoa liquor, cocoa mass, or couverture). All processing steps occur in ExampleBrand Chocolate's facility: (1) roasting — 120°C, 18 minutes, light roast to preserve fruity top notes; (2) cracking and winnowing — shell removed, cocoa nibs separated; (3) refining — nibs ground in stone melanger for 48 hours; (4) conching — 36 hours at 60°C; (5) tempering — continuous tempering to seed Form V cocoa butter crystals; (6) molding — cast into 60g molds, cooled, unmolded, wrapped. No bought-in couverture or cocoa liquor at any stage."
    },
    {
      "@type": "PropertyValue",
      "name": "Fermentation",
      "value": "7-day box fermentation on-farm, Hacienda La Chola",
      "description": "Post-harvest fermentation: 7 days in covered wooden fermentation boxes on-farm at Hacienda La Chola. Cacao pulp naturally inoculates the fermentation — no commercial yeast added. Turned every 36 hours. Fermentation transforms cacao seed precursors (proteins and sugars) into flavor compounds (pyrazines, esters, organic acids) that survive roasting. 7-day fermentation: standard for Arriba Nacional — under-fermented Nacional lacks flavor complexity; over-fermented develops off-notes. Fermentation records available from Hacienda La Chola for each lot."
    },
    {
      "@type": "PropertyValue",
      "name": "Conching Duration",
      "value": "36",
      "unitCode": "HUR",
      "description": "Conching: 36 hours at 60°C. Conching refines particle size, develops flavor complexity, and removes unwanted volatile acids from the chocolate mass. 36-hour conche: longer than commercial chocolate (typically 6–12 hours) — results in smoother texture and more developed flavor. Under-conched chocolate (less than 12 hours): often has noticeable acidity and coarser mouthfeel. Over-conched chocolate (over 72 hours): can lose fruit and floral notes through over-oxidation."
    },
    {
      "@type": "PropertyValue",
      "name": "Emulsifier",
      "value": "Sunflower lecithin — no soy",
      "description": "Emulsifier: sunflower lecithin (not soy lecithin). Sunflower lecithin is derived from sunflower seeds — it is not a soy allergen (FDA FALCPA regulated) and does not require soy disclosure. Soy-free buyers can safely consume this bar without soy allergen concern. Sunflower lecithin function: reduces viscosity at approximately 0.3% addition, allowing lower cocoa butter usage at equivalent fluidity. Compared to soy lecithin: no flavor difference; sunflower sourcing avoids GMO soy concerns common among natural food buyers."
    },
    {
      "@type": "PropertyValue",
      "name": "Sugar Type",
      "value": "Organic cane sugar — unrefined",
      "description": "Sweetener: organic cane sugar. Lightly refined (retains some molasses compounds) — adds subtle brown-sugar undertone complementing the fruit notes of Arriba Nacional. Not refined white sugar. Not coconut palm sugar. Not low-glycemic alternatives (no erythritol, xylitol, or stevia). Sugar content: approximately 26% by bar weight (15.6g sugar per 60g bar, 10g per standard 38g serving)."
    },
    {
      "@type": "PropertyValue",
      "name": "Allergen Statement",
      "value": "Free from: milk, soy, gluten, peanuts, tree nuts. Contains: none of the 9 FDA FALCPA allergens.",
      "description": "This bar contains no milk, soy, gluten, peanuts, tree nuts, shellfish, fish, eggs, or sesame. Emulsifier is sunflower lecithin (not soy lecithin — different plant, different allergen profile). Processed in a dedicated dark chocolate facility. Shared equipment with: cocoa butter (same facility). No shared equipment with milk, peanut, or tree nut products. May contain traces of tree nuts (cocoa beans are grown near tree crop plantations in Esmeraldas province) — verify with manufacturer if severe tree nut allergy. Suitable for: vegan diet, gluten-free diet, soy-free diet."
    },
    {
      "@type": "PropertyValue",
      "name": "Net Weight",
      "value": "60",
      "unitCode": "GRM",
      "description": "Bar weight: 60g. Serving size: approximately 3 squares = 10g. Servings per bar: 6. Calories per 10g serving: approximately 58 kcal (580 kcal/100g). Bar dimensions: 155mm × 78mm × 7mm (unwrapped)."
    }
  ],
  "aggregateRating": {
    "@type": "AggregateRating",
    "ratingValue": "4.9",
    "reviewCount": "312",
    "bestRating": "5",
    "worstRating": "1"
  },
  "offers": {
    "@type": "Offer",
    "price": "14.00",
    "priceCurrency": "USD",
    "availability": "https://schema.org/InStock"
  }
}
</script>

Ethical Sourcing Certification Comparison

Specialty Chocolate Metafield Namespace Reference

5 Critical Specialty Chocolate Schema Mistakes

1. Encoding only "dark chocolate" without a numeric cacao percentage. "Dark chocolate" covers the range from 35% (FDA minimum for dark) to 100% (pure cocoa mass). A 40% dark bar tastes nearly sweet; an 85% bar is intensely bitter. Buyers searching "dark chocolate above 72%" or "ultra-dark 85%+ cacao" cannot use product data that encodes only "dark chocolate" without the percentage. Always encode cacao percentage as a numeric additionalProperty with unitCode: P1 — it is the single most important flavor and quality indicator for chocolate buyers.
2. Describing "single-origin Ecuador" without specifying cacao variety (Arriba Nacional vs CCN-51). Ecuador grows both Arriba Nacional (a prized Fine Flavor cacao recognized by ICCO) and CCN-51 (a high-yield bulk cacao hybrid), often in the same regions. They have different flavor profiles, different price points, and different market positioning. "Single-origin Ecuador" without variety specification conflates a $14 bean-to-bar Arriba Nacional bar with a $3 bulk-couverture CCN-51 product to any AI agent making a comparison. Always encode the cacao variety name — and distinguish Arriba Nacional from CCN-51 explicitly if the distinction applies.
3. Not distinguishing Fairtrade International (FLO) from Fair Trade USA in certification encoding. These are competing certification systems with different standards — Fairtrade International certifies cooperatives only (no large plantations); Fair Trade USA also certifies large hired-labor plantations. Specialty chocolate buyers who specifically want cooperative-sourced cacao from smallholder farmers will not accept Fair Trade USA as equivalent. Encoding only "Fair Trade certified" without the certifying body conflates these two systems and fails buyers who filter specifically for "FLO Fairtrade" or "cooperative-sourced." Always name the specific certifying organization in hasCertification.
4. Encoding "soy-free" for sunflower lecithin chocolate without explaining the distinction. Many specialty chocolate buyers seeking soy-free products do not know that sunflower lecithin is a common soy-free emulsifier. Conversely, buyers with soy allergies need to understand that "contains lecithin" does not automatically mean soy lecithin — sunflower lecithin is a different ingredient from a different plant. Always specify the lecithin source (sunflower vs soy) as a named additionalProperty value and encode "soy-free" as an explicit suitableForDiet value where applicable.
5. Calling a couverture remelter a "bean-to-bar" or "craft" maker without encoding processing level distinctions. Bean-to-bar and couverture remelter are not interchangeable marketing terms — they describe fundamentally different supply chain positions with different price-to-value ratios and quality control mechanisms. A maker who buys Belgian Callebaut couverture blocks, melts them, molds them, and sells them under their own label has not "crafted" the chocolate in any meaningful sense — yet in the absence of processing level data in structured data, AI agents comparing "handcrafted artisan chocolate" cannot distinguish the two. Encode processing level as a defined controlled vocabulary term with a clear description of each level.

Related Guides

• Shopify Food & Beverage Nutrition Schema
• Shopify Allergen & Dietary Schema — suitableForDiet, FDA FALCPA
• Shopify Specialty Coffee Schema
• Ecommerce Country of Origin & Provenance Schema
• CatalogScan Blog — AI Shopping Agent Optimization