Shopify Candle & Home Fragrance Schema — Scent Notes, Burn Time, Wax Type & Leaping Bunny Structured Data

Why Candle & Fragrance Products Need Specialized Structured Data

Candles and home fragrance products have a dense scent vocabulary that AI shopping agents must parse to match purchase intent. A shopper searching "warm cozy fall candle" is querying by scent family (gourmand/spicy/woody) and mood — not product name. A shopper searching "50-hour burn time soy candle" needs a structured numeric attribute. Neither query can be resolved from Shopify's default JSON-LD output, which contains no fragrance or burn data.

The home fragrance market reached $10.6 billion in 2024 and is dominated by DTC Shopify brands. CatalogScan's scanning data shows that fewer than 3% of Shopify candle stores have any fragrance note, burn time, or wax type structured data. The gap between what customers search for and what brands provide in machine-readable form is wider in home fragrance than in almost any other Shopify category.

Fragrance query types and required structured data

Full Candle Product Schema — Soy Candle Example

This example covers a premium soy candle with a full scent note pyramid, burn time, wax type, wick material, certifications, and fire safety disclaimer.

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Product",
  "name": "Dusk Soy Candle — Bergamot, Jasmine & Sandalwood — 8 oz, 50-Hour Burn",
  "description": "Hand-poured 100% natural soy wax candle with a three-wick cotton wick blend. Fragrance pyramid: fresh bergamot and green tea top notes, jasmine and rose middle notes, warm sandalwood and white musk base notes. 8 oz (226g) in reusable matte black glass vessel. 50-hour burn time. Leaping Bunny certified cruelty-free, 100% vegan. Phthalate-free fragrance oil.",
  "sku": "CSC-DUSK-8OZ",
  "brand": { "@type": "Brand", "name": "Ember & Bloom" },
  "material": "100% natural soy wax, cotton-paper wick blend, phthalate-free fragrance oil, matte black glass vessel",
  "legalDisclaimer": "CANDLE SAFETY: Never leave burning candle unattended. Keep away from children and pets. Burn on heat-resistant surface. Keep away from flammable materials. Trim wick to 1/4 inch before each use. Do not burn more than 4 hours at a time. Stop use when 1/2 inch wax remains.",
  "safetyConsideration": "Open flame product. Keep away from children, pets, and flammable materials. Never leave unattended while burning.",
  "sustainabilityFeature": "100% natural soy wax from US-grown soybeans. Phthalate-free fragrance oil. Cotton-paper wick (no lead, no zinc). Reusable and recyclable glass vessel. Leaping Bunny certified cruelty-free. Vegan — no beeswax or animal-derived ingredients.",
  "hasCertification": [
    {
      "@type": "Certification",
      "name": "Leaping Bunny Certified — Cruelty-Free",
      "issuedBy": {
        "@type": "Organization",
        "name": "Leaping Bunny Program",
        "url": "https://www.leapingbunny.org"
      },
      "url": "https://www.leapingbunny.org/guide/brands"
    },
    {
      "@type": "Certification",
      "name": "PETA Beauty Without Bunnies — Vegan & Cruelty-Free",
      "issuedBy": {
        "@type": "Organization",
        "name": "PETA",
        "url": "https://www.peta.org/living/personal-care-fashion/beauty-without-bunnies/"
      }
    }
  ],
  "additionalProperty": [
    { "@type": "PropertyValue", "name": "Product Type", "value": "Candle — Soy Container Candle" },
    { "@type": "PropertyValue", "name": "Scent Name", "value": "Dusk" },
    { "@type": "PropertyValue", "name": "Scent Family", "value": "Floral-Woody", "description": "Balanced floral jasmine and rose heart with warm woody sandalwood and musk base. Fresh bergamot opening." },
    { "@type": "PropertyValue", "name": "Top Notes", "value": "bergamot, green tea, fresh citrus", "description": "The first scent impression — bright, airy notes that appear in the first 15 minutes of burning and fade as wax pools." },
    { "@type": "PropertyValue", "name": "Middle Notes", "value": "jasmine, rose, peony", "description": "Heart notes — the dominant character of the fragrance, present throughout the burn." },
    { "@type": "PropertyValue", "name": "Base Notes", "value": "sandalwood, white musk, cedarwood, vanilla", "description": "Foundation notes that deepen and linger longest — sandalwood and white musk give the warm, cozy finish." },
    { "@type": "PropertyValue", "name": "Burn Time", "value": "50", "unitCode": "HUR", "description": "Approximately 50 hours. Trim wick to 1/4 inch before each burn and allow wax to pool to edges on first burn for maximum performance." },
    { "@type": "PropertyValue", "name": "Wax Type", "value": "Soy Wax", "description": "100% natural soy wax from US-grown soybeans. Clean-burning, biodegradable, vegan. Burns cooler than paraffin for longer throw." },
    { "@type": "PropertyValue", "name": "Wick Material", "value": "Cotton-Paper Blend", "description": "Lead-free, zinc-free cotton-paper wick. Produces a clean, stable flame with minimal mushrooming." },
    { "@type": "PropertyValue", "name": "Vessel Type", "value": "Glass — Matte Black", "description": "Reusable matte black glass jar. Clean with hot water after use." },
    { "@type": "PropertyValue", "name": "Net Weight", "value": "226", "unitCode": "GRM", "description": "226 grams (8 oz) of soy wax" },
    { "@type": "PropertyValue", "name": "Fragrance Load", "value": "12", "unitCode": "P1", "description": "12% fragrance load — high-concentration for strong, room-filling throw" },
    { "@type": "PropertyValue", "name": "Phthalate-Free", "value": "Yes", "description": "Fragrance oil is phthalate-free and IFRA-compliant" },
    { "@type": "PropertyValue", "name": "Room Suitability", "value": "Bedroom, living room, bathroom, office", "description": "Medium throw suitable for rooms up to 400 sq ft" },
    { "@type": "PropertyValue", "name": "Vegan", "value": "Yes", "description": "No beeswax, no animal-derived fragrance ingredients. 100% vegan formulation." }
  ],
  "offers": {
    "@type": "Offer",
    "price": "28.00",
    "priceCurrency": "USD",
    "availability": "https://schema.org/InStock",
    "url": "https://example-candles.myshopify.com/products/dusk-soy-candle-bergamot-jasmine-sandalwood"
  }
}
</script>

Reed Diffuser & Wax Melt Schema

Reed diffusers and wax melts share the fragrance note pyramid with candles but replace burn time with diffuser fill volume and longevity. Wax melts require a warmer and have no open flame.

{
  "@context": "https://schema.org",
  "@type": "Product",
  "name": "Nordic Cedar Reed Diffuser — 100ml, 4-6 Month Longevity",
  "description": "Luxury reed diffuser with 9 natural rattan reeds and 100ml of fragrance oil blend. Nordic cedar, juniper berry, and smoky vetiver scent profile. 4-6 month longevity at half-reed placement.",
  "material": "Fragrance oil (phthalate-free, IFRA-compliant), natural rattan reeds, glass vessel",
  "legalDisclaimer": "DIFFUSER SAFETY: Keep away from children and pets. Keep away from polished wood, lacquered or painted surfaces — fragrance oil may cause damage. Avoid contact with skin and eyes. If skin contact occurs, wash with soap and water.",
  "safetyConsideration": "Fragrance oil product. Keep away from children, pets, and finished surfaces. Not for oral consumption.",
  "additionalProperty": [
    { "@type": "PropertyValue", "name": "Product Type", "value": "Reed Diffuser" },
    { "@type": "PropertyValue", "name": "Scent Family", "value": "Woody-Earthy" },
    { "@type": "PropertyValue", "name": "Top Notes", "value": "juniper berry, eucalyptus" },
    { "@type": "PropertyValue", "name": "Middle Notes", "value": "cedarwood, pine needle" },
    { "@type": "PropertyValue", "name": "Base Notes", "value": "vetiver, smoky birch, oakmoss" },
    { "@type": "PropertyValue", "name": "Fill Volume", "value": "100", "unitCode": "MLT", "description": "100ml fragrance oil" },
    { "@type": "PropertyValue", "name": "Reed Count", "value": "9", "description": "9 natural rattan diffuser reeds included" },
    { "@type": "PropertyValue", "name": "Diffuser Longevity", "value": "4-6 months at half-reed placement", "description": "Use all 9 reeds for stronger throw (2-3 months), half reeds for subtle scent (4-6 months)" },
    { "@type": "PropertyValue", "name": "Vessel Type", "value": "Glass — Clear Round" },
    { "@type": "PropertyValue", "name": "Room Suitability", "value": "Entryway, bathroom, bedroom, office", "description": "Best in rooms up to 300 sq ft" },
    { "@type": "PropertyValue", "name": "Phthalate-Free", "value": "Yes" }
  ]
}

Wax Type Reference

Scent Family Reference

Dawn Liquid Snippet: candle.* Metafield Namespace

Save as snippets/candle-product-schema.liquid. Activates for products tagged candle, diffuser, or in the home-fragrance collection.

{% comment %} candle-product-schema.liquid — candle and home fragrance structured data {% endcomment %}
{% assign is_candle = false %}
{% if product.tags contains 'candle' or product.tags contains 'diffuser' or product.tags contains 'wax-melt' or product.tags contains 'home-fragrance' %}
  {% assign is_candle = true %}
{% endif %}
{% for collection in product.collections %}
  {% if collection.handle == 'candles' or collection.handle == 'home-fragrance' or collection.handle == 'diffusers' %}
    {% assign is_candle = true %}
  {% endif %}
{% endfor %}

{% if is_candle %}
{% assign scent_name    = product.metafields.candle.scent_name %}
{% assign scent_family  = product.metafields.candle.scent_family %}
{% assign top_notes     = product.metafields.candle.top_notes %}
{% assign middle_notes  = product.metafields.candle.middle_notes %}
{% assign base_notes    = product.metafields.candle.base_notes %}
{% assign burn_time     = product.metafields.candle.burn_time_hours %}
{% assign wax_type      = product.metafields.candle.wax_type %}
{% assign wick_material = product.metafields.candle.wick_material %}
{% assign vessel_type   = product.metafields.candle.vessel_type %}
{% assign net_weight_g  = product.metafields.candle.net_weight_grams %}
{% assign is_vegan      = product.metafields.candle.vegan %}
{% assign is_leaping    = product.metafields.candle.leaping_bunny %}
{% assign sustainability= product.metafields.candle.sustainability_statement %}
{% assign safety_note   = product.metafields.candle.fire_safety_disclaimer %}

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Product",
  "name": {{ product.title | json }},
  "description": {{ product.description | strip_html | truncatewords: 80 | json }},
  "url": "{{ shop.url }}{{ product.url }}",
  "sku": {{ product.selected_or_first_available_variant.sku | json }}
  {% if product.vendor != blank %}
  ,"brand": { "@type": "Brand", "name": {{ product.vendor | json }} }
  {% endif %}
  {% if wax_type != blank %}
  ,"material": {{ wax_type | append: " wax candle, " | append: product.title | truncatewords: 8 | json }}
  {% endif %}
  {% if safety_note != blank %}
  ,"legalDisclaimer": {{ safety_note | json }}
  ,"safetyConsideration": "Open flame product. Keep away from children, pets, and flammable materials. Never leave unattended."
  {% endif %}
  {% if sustainability != blank %}
  ,"sustainabilityFeature": {{ sustainability | json }}
  {% endif %}
  {% if is_leaping == "true" or is_leaping == true %}
  ,"hasCertification": [
    { "@type": "Certification", "name": "Leaping Bunny Certified — Cruelty-Free", "issuedBy": { "@type": "Organization", "name": "Leaping Bunny Program", "url": "https://www.leapingbunny.org" } }
  ]
  {% endif %}
  ,"additionalProperty": [
    {% assign ap_s = false %}
    {% if scent_name != blank %}
    { "@type": "PropertyValue", "name": "Scent Name", "value": {{ scent_name | json }} }
    {% assign ap_s = true %}
    {% endif %}
    {% if scent_family != blank %}
    {% if ap_s %},{% endif %}{ "@type": "PropertyValue", "name": "Scent Family", "value": {{ scent_family | json }} }
    {% assign ap_s = true %}
    {% endif %}
    {% if top_notes != blank %}
    ,{ "@type": "PropertyValue", "name": "Top Notes", "value": {{ top_notes | json }} }
    {% endif %}
    {% if middle_notes != blank %}
    ,{ "@type": "PropertyValue", "name": "Middle Notes", "value": {{ middle_notes | json }} }
    {% endif %}
    {% if base_notes != blank %}
    ,{ "@type": "PropertyValue", "name": "Base Notes", "value": {{ base_notes | json }} }
    {% endif %}
    {% if burn_time != blank %}
    ,{ "@type": "PropertyValue", "name": "Burn Time", "value": {{ burn_time | json }}, "unitCode": "HUR" }
    {% endif %}
    {% if wax_type != blank %}
    ,{ "@type": "PropertyValue", "name": "Wax Type", "value": {{ wax_type | json }} }
    {% endif %}
    {% if wick_material != blank %}
    ,{ "@type": "PropertyValue", "name": "Wick Material", "value": {{ wick_material | json }} }
    {% endif %}
    {% if vessel_type != blank %}
    ,{ "@type": "PropertyValue", "name": "Vessel Type", "value": {{ vessel_type | json }} }
    {% endif %}
    {% if net_weight_g != blank %}
    ,{ "@type": "PropertyValue", "name": "Net Weight", "value": {{ net_weight_g | json }}, "unitCode": "GRM" }
    {% endif %}
    {% if is_vegan == "true" or is_vegan == true %}
    ,{ "@type": "PropertyValue", "name": "Vegan", "value": "Yes" }
    {% endif %}
  ]
  ,"offers": {
    "@type": "Offer",
    "price": {{ product.selected_or_first_available_variant.price | money_without_currency | json }},
    "priceCurrency": {{ cart.currency.iso_code | json }},
    "availability": {% if product.available %}"https://schema.org/InStock"{% else %}"https://schema.org/OutOfStock"{% endif %},
    "url": "{{ shop.url }}{{ product.url }}"
  }
}
</script>
{% endif %}

candle.* metafield namespace

5 Common Candle Schema Mistakes

Related Resources

• Shopify Cosmetics & Beauty Product Schema
• Shopify Handmade & Artisan Product Schema
• Product Safety Certifications Schema
• Shopify Subscription Box Schema
• Ecommerce Carbon Offset & Eco Shipping Schema
• CatalogScan Blog — AI Shopping Agent Optimization