Shopify Jewelry & Gemstone Schema — GIA Certificates, Metal Purity, Ring Size & Conflict-Free Markup

Why Jewelry Needs Specialized Structured Data

Jewelry is one of the highest-consideration purchase categories on Shopify, with buyers applying precise quality filters that no other product category demands. AI shopping agents processing jewelry queries must reconcile gem-industry terminology (GIA cut grades, Rapaport color/clarity grids, carat weight decimals) with schema.org vocabulary. Without explicit structured data bridging these two worlds, even a perfectly written product description leaves the AI agent guessing.

The commercial stakes are asymmetric. A 1.5 carat VS1 G-color diamond has a radically different price and audience than a 1.5 carat SI2 J-color diamond — yet both products will appear identically in Shopify's default JSON-LD output: name and price, nothing else. AI agents answering "best value engagement ring, VS2 or better, G-H color, between 1 and 1.5 carat" will skip both products entirely if they can't verify quality from structured data.

Jewelry schema priority by query type

Full Jewelry Product Schema — Diamond Engagement Ring Example

The following example covers all the high-value structured data properties for a natural diamond solitaire ring. It combines the 4Cs, metal purity, ring size variants via ProductGroup, GIA certificate, and Kimberley Process ethical sourcing certification.

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "ProductGroup",
  "name": "Lumina Solitaire Diamond Engagement Ring — 1.21ct Round Brilliant, VS1/G, 14k White Gold",
  "description": "Handcrafted solitaire engagement ring featuring a 1.21 carat round brilliant-cut natural diamond, GIA certified VS1 clarity, G color, Excellent cut. Set in 14k white gold (585 hallmark). Conflict-free diamond sourced under the Kimberley Process Certification Scheme. Available in sizes 4–10 (US), including half sizes.",
  "url": "https://example-jewelry.myshopify.com/products/lumina-solitaire-1-21ct-vs1-g-14k-white-gold",
  "brand": { "@type": "Brand", "name": "Lumina Fine Jewelry" },
  "material": "14k white gold (585), natural round brilliant diamond",
  "sustainabilityFeature": "Natural conflict-free diamond certified under the Kimberley Process Certification Scheme. 14k white gold from Responsible Jewellery Council certified refinery. Recycled metal setting available on request.",
  "hasCertification": [
    {
      "@type": "Certification",
      "name": "GIA Diamond Grading Report",
      "issuedBy": {
        "@type": "Organization",
        "name": "Gemological Institute of America (GIA)",
        "url": "https://www.gia.edu"
      },
      "certificationIdentification": "2141438171",
      "url": "https://www.gia.edu/report-check?reportno=2141438171"
    },
    {
      "@type": "Certification",
      "name": "Kimberley Process Certification Scheme (KPCS)",
      "issuedBy": {
        "@type": "Organization",
        "name": "Kimberley Process",
        "url": "https://www.kimberleyprocess.com"
      },
      "name": "Conflict-Free Diamond — Kimberley Process Certified",
      "description": "Natural diamond sourced under the Kimberley Process Certification Scheme, certifying the diamond is conflict-free."
    },
    {
      "@type": "Certification",
      "name": "Responsible Jewellery Council Certification",
      "issuedBy": {
        "@type": "Organization",
        "name": "Responsible Jewellery Council (RJC)",
        "url": "https://www.responsiblejewellery.com"
      }
    }
  ],
  "additionalProperty": [
    { "@type": "PropertyValue", "name": "Stone Type", "value": "Natural Diamond" },
    { "@type": "PropertyValue", "name": "Diamond Origin", "value": "Natural Mined" },
    { "@type": "PropertyValue", "name": "Carat Weight", "value": "1.21", "unitCode": "OZT", "description": "1.21 carats total diamond carat weight" },
    { "@type": "PropertyValue", "name": "Cut Grade", "value": "Excellent" },
    { "@type": "PropertyValue", "name": "Color Grade", "value": "G", "description": "GIA color scale: D (colorless) to Z (light yellow). G = near-colorless." },
    { "@type": "PropertyValue", "name": "Clarity Grade", "value": "VS1", "description": "Very Slightly Included 1 — inclusions difficult to see under 10x magnification." },
    { "@type": "PropertyValue", "name": "Diamond Shape", "value": "Round Brilliant" },
    { "@type": "PropertyValue", "name": "GIA Report Number", "value": "2141438171" },
    { "@type": "PropertyValue", "name": "Metal Type", "value": "White Gold" },
    { "@type": "PropertyValue", "name": "Metal Purity", "value": "585", "description": "14 karat white gold — 58.5% pure gold alloy" },
    { "@type": "PropertyValue", "name": "Hallmark", "value": "585 14K" },
    { "@type": "PropertyValue", "name": "Setting Style", "value": "Solitaire Prong" },
    { "@type": "PropertyValue", "name": "Prong Count", "value": "4" },
    { "@type": "PropertyValue", "name": "Ring Width", "value": "2.1", "unitCode": "MMT", "description": "2.1mm band width" }
  ],
  "variesBy": ["https://schema.org/size"],
  "hasVariant": [
    {
      "@type": "Product",
      "name": "Lumina Solitaire Diamond Ring — Size 6 US",
      "sku": "LUMINA-SOL-1.21-VS1G-14KW-US6",
      "size": {
        "@type": "SizeSpecification",
        "name": "6",
        "sizeSystem": "https://schema.org/WearableSizeSystemUS",
        "sizeGroup": "https://schema.org/WearableSizeGroupRegular"
      },
      "offers": {
        "@type": "Offer",
        "price": "7850.00",
        "priceCurrency": "USD",
        "availability": "https://schema.org/InStock",
        "url": "https://example-jewelry.myshopify.com/products/lumina-solitaire-1-21ct-vs1-g-14k-white-gold?variant=us6"
      }
    },
    {
      "@type": "Product",
      "name": "Lumina Solitaire Diamond Ring — Size 7 US",
      "sku": "LUMINA-SOL-1.21-VS1G-14KW-US7",
      "size": {
        "@type": "SizeSpecification",
        "name": "7",
        "sizeSystem": "https://schema.org/WearableSizeSystemUS",
        "sizeGroup": "https://schema.org/WearableSizeGroupRegular"
      },
      "offers": {
        "@type": "Offer",
        "price": "7850.00",
        "priceCurrency": "USD",
        "availability": "https://schema.org/InStock",
        "url": "https://example-jewelry.myshopify.com/products/lumina-solitaire-1-21ct-vs1-g-14k-white-gold?variant=us7"
      }
    }
  ]
}
</script>

The 4Cs as additionalProperty — GIA Grade Vocabulary

The 4Cs (cut, color, clarity, and carat weight) are the gemological industry standard for diamond quality, codified by GIA. Each grade is a controlled vocabulary term — using "Excellent" vs "EX" vs "Exc" matters because AI agents trained on GIA terminology expect exact grade strings. Use GIA's official grade values for each property.

GIA cut grades

GIA color grades (D–Z)

GIA clarity grades

Carat weight uses a decimal number string — do not round. A 1.21ct diamond should be "1.21", not "1.2" or "1". Use unitCode: "OZT" (troy ounce as UN/CEFACT analogue for gemological weight) or simply a plain string value with the unit in the description field: "description": "1.21 carats".

Lab-Grown Diamond Schema: CVD, HPHT, and IGI Certification

Lab-grown diamonds have overtaken natural diamonds in market share for sub-1ct stones. AI shopping agents need to distinguish lab-grown from natural — shoppers specifically searching "lab-grown diamond engagement ring" want lab-created stones, not natural ones. The key differentiator in structured data is the additionalProperty for Diamond Origin and Growth Method, and hasCertification with IGI or GCAL rather than GIA (though GIA now grades lab diamonds too).

{
  "@type": "Product",
  "name": "1.50ct Lab-Grown Round Diamond — CVD, VS1/E, IGI Certified — Platinum 950 Solitaire",
  "material": "Platinum 950, IGI-certified lab-grown diamond",
  "sustainabilityFeature": "Lab-grown diamond created using CVD (Chemical Vapor Deposition) technology. Zero mining impact. Platinum 950 from recycled sources. Carbon-neutral manufacturing.",
  "hasCertification": [
    {
      "@type": "Certification",
      "name": "IGI Diamond Grading Report — Lab-Grown",
      "issuedBy": {
        "@type": "Organization",
        "name": "International Gemological Institute (IGI)",
        "url": "https://www.igi.org"
      },
      "certificationIdentification": "LG521437892",
      "url": "https://www.igi.org/verify-your-report/?r=LG521437892"
    }
  ],
  "additionalProperty": [
    { "@type": "PropertyValue", "name": "Stone Type", "value": "Lab-Grown Diamond" },
    { "@type": "PropertyValue", "name": "Diamond Origin", "value": "Lab-Grown" },
    { "@type": "PropertyValue", "name": "Growth Method", "value": "CVD", "description": "Chemical Vapor Deposition — carbon atoms deposited in a vacuum chamber layer by layer" },
    { "@type": "PropertyValue", "name": "Carat Weight", "value": "1.50", "description": "1.50 carats" },
    { "@type": "PropertyValue", "name": "Cut Grade", "value": "Excellent" },
    { "@type": "PropertyValue", "name": "Color Grade", "value": "E" },
    { "@type": "PropertyValue", "name": "Clarity Grade", "value": "VS1" },
    { "@type": "PropertyValue", "name": "Diamond Shape", "value": "Round Brilliant" },
    { "@type": "PropertyValue", "name": "Metal Type", "value": "Platinum" },
    { "@type": "PropertyValue", "name": "Metal Purity", "value": "950", "description": "Platinum 950 — 95% pure platinum" },
    { "@type": "PropertyValue", "name": "Hallmark", "value": "PLAT 950" }
  ]
}

Metal Purity and Hallmark Reference

Metal purity is expressed in fineness (parts per thousand) or karat for gold. Use the numeric fineness in the additionalProperty value for machine readability, and include the human-readable karat or purity description in the description field.

Dawn Liquid Snippet: Jewelry JSON-LD from Metafields

Save as snippets/jewelry-product-schema.liquid. Activates for products tagged jewelry, diamond-ring, or in the jewelry collection. Uses a jewelry.* metafield namespace.

{% comment %} jewelry-product-schema.liquid — gemstone + metal jewelry schema {% endcomment %}
{% assign is_jewelry = false %}
{% if product.tags contains 'jewelry' or product.tags contains 'diamond-ring' or product.tags contains 'fine-jewelry' %}
  {% assign is_jewelry = true %}
{% endif %}
{% for collection in product.collections %}
  {% if collection.handle == 'jewelry' or collection.handle == 'engagement-rings' or collection.handle == 'fine-jewelry' %}
    {% assign is_jewelry = true %}
  {% endif %}
{% endfor %}

{% if is_jewelry %}

{% assign stone_type       = product.metafields.jewelry.stone_type %}
{% assign diamond_origin   = product.metafields.jewelry.diamond_origin %}
{% assign carat_weight     = product.metafields.jewelry.carat_weight %}
{% assign cut_grade        = product.metafields.jewelry.cut_grade %}
{% assign color_grade      = product.metafields.jewelry.color_grade %}
{% assign clarity_grade    = product.metafields.jewelry.clarity_grade %}
{% assign diamond_shape    = product.metafields.jewelry.diamond_shape %}
{% assign cert_org         = product.metafields.jewelry.cert_org %}
{% assign cert_number      = product.metafields.jewelry.cert_number %}
{% assign metal_type       = product.metafields.jewelry.metal_type %}
{% assign metal_purity     = product.metafields.jewelry.metal_purity %}
{% assign hallmark         = product.metafields.jewelry.hallmark %}
{% assign setting_style    = product.metafields.jewelry.setting_style %}
{% assign sustainability   = product.metafields.jewelry.sustainability_statement %}
{% assign growth_method    = product.metafields.jewelry.growth_method %}

<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.selected_or_first_available_variant.barcode != blank %}
  ,"gtin": {{ product.selected_or_first_available_variant.barcode | json }}
  {% endif %}
  {% if product.vendor != blank %}
  ,"brand": { "@type": "Brand", "name": {{ product.vendor | json }} }
  {% endif %}
  {% if product.metafields.jewelry.material != blank %}
  ,"material": {{ product.metafields.jewelry.material | json }}
  {% endif %}
  {% if sustainability != blank %}
  ,"sustainabilityFeature": {{ sustainability | json }}
  {% endif %}
  {% if cert_number != blank %}
  ,"hasCertification": [{
    "@type": "Certification",
    "name": {% if cert_org == 'GIA' %}"GIA Diamond Grading Report"{% elsif cert_org == 'IGI' %}"IGI Diamond Grading Report"{% elsif cert_org == 'AGS' %}"AGS Diamond Quality Document"{% else %}{{ cert_org | append: " Gemstone Certificate" | json }}{% endif %},
    "issuedBy": { "@type": "Organization", "name": {{ cert_org | json }} },
    "certificationIdentification": {{ cert_number | json }}
    {% if cert_org == 'GIA' %},"url": {{ "https://www.gia.edu/report-check?reportno=" | append: cert_number | json }}{% endif %}
    {% if cert_org == 'IGI' %},"url": {{ "https://www.igi.org/verify-your-report/?r=" | append: cert_number | json }}{% endif %}
  }]
  {% endif %}
  ,"additionalProperty": [
    {% assign props_started = false %}
    {% if stone_type != blank %}
    { "@type": "PropertyValue", "name": "Stone Type", "value": {{ stone_type | json }} }
    {% assign props_started = true %}
    {% endif %}
    {% if diamond_origin != blank %}
    {% if props_started %},{% endif %}{ "@type": "PropertyValue", "name": "Diamond Origin", "value": {{ diamond_origin | json }} }
    {% assign props_started = true %}
    {% endif %}
    {% if growth_method != blank %}
    ,{ "@type": "PropertyValue", "name": "Growth Method", "value": {{ growth_method | json }} }
    {% endif %}
    {% if carat_weight != blank %}
    ,{ "@type": "PropertyValue", "name": "Carat Weight", "value": {{ carat_weight | json }}, "description": {{ carat_weight | append: " carats" | json }} }
    {% endif %}
    {% if cut_grade != blank %}
    ,{ "@type": "PropertyValue", "name": "Cut Grade", "value": {{ cut_grade | json }} }
    {% endif %}
    {% if color_grade != blank %}
    ,{ "@type": "PropertyValue", "name": "Color Grade", "value": {{ color_grade | json }} }
    {% endif %}
    {% if clarity_grade != blank %}
    ,{ "@type": "PropertyValue", "name": "Clarity Grade", "value": {{ clarity_grade | json }} }
    {% endif %}
    {% if diamond_shape != blank %}
    ,{ "@type": "PropertyValue", "name": "Diamond Shape", "value": {{ diamond_shape | json }} }
    {% endif %}
    {% if metal_type != blank %}
    ,{ "@type": "PropertyValue", "name": "Metal Type", "value": {{ metal_type | json }} }
    {% endif %}
    {% if metal_purity != blank %}
    ,{ "@type": "PropertyValue", "name": "Metal Purity", "value": {{ metal_purity | json }} }
    {% endif %}
    {% if hallmark != blank %}
    ,{ "@type": "PropertyValue", "name": "Hallmark", "value": {{ hallmark | json }} }
    {% endif %}
    {% if setting_style != blank %}
    ,{ "@type": "PropertyValue", "name": "Setting Style", "value": {{ setting_style | json }} }
    {% 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 %}

jewelry.* metafield namespace

5 Common Jewelry Schema Mistakes

Related Resources

• Shopify Clothing & Apparel Size Schema
• Shopify Visual Artwork & Collectibles Schema
• Shopify Pre-Owned & Resale Condition Schema
• Product Safety Certifications Schema
• Ecommerce Product Condition Structured Data
• CatalogScan Blog — AI Shopping Agent Optimization