Shopify Craft Supplies & Art Materials Schema — Yarn Gauge, Paint Pigment, ACMI Non-Toxic & Skill Level Structured Data

Yarn Product Schema — Superwash Merino Example

Yarn buyers filter by weight category, fiber content, yardage, and machine-washability — four properties entirely absent from Shopify's default JSON-LD. This example covers the complete structured data for a skein of fingering weight superwash merino.

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Product",
  "name": "Malabrigo Sock Yarn — Superwash Merino, 440 yards, Worsted Weight — Ravelry Red",
  "description": "Malabrigo Sock single-ply superwash merino wool yarn. 100g skein, 440 yards (402m). Hand-dyed, kettle-dyed colorway. CYC Weight 1 — Super Fine (Fingering/Sock). Recommended for socks, shawls, lightweight garments. Machine washable (superwash treated wool).",
  "sku": "MAL-SOCK-RAVRED",
  "brand": { "@type": "Brand", "name": "Malabrigo Yarn" },
  "material": "100% Superwash Merino Wool",
  "suggestedAudience": {
    "@type": "PeopleAudience",
    "audienceType": "Intermediate to Advanced Knitter or Crocheter",
    "suggestedMinAge": 12
  },
  "additionalProperty": [
    { "@type": "PropertyValue", "name": "Craft Material Type", "value": "Yarn" },
    { "@type": "PropertyValue", "name": "Yarn Weight Category", "value": "1 — Super Fine (Fingering/Sock/Baby)", "description": "CYC Yarn Weight 1 — Super Fine. Knitting gauge: 27-32 sts per 4 inches on US size 1-3 (2.25-3.25mm) needles. Crochet gauge: 21-32 sc per 4 inches on US B-1 to E-4 (2.25-3.5mm) hook." },
    { "@type": "PropertyValue", "name": "Gauge (Knitting)", "value": "28 stitches x 36 rows per 4 inches on US size 2 (2.75mm) needles", "description": "Stockinette stitch gauge. Always swatch before beginning a project." },
    { "@type": "PropertyValue", "name": "Fiber Content", "value": "100% Superwash Merino Wool" },
    { "@type": "PropertyValue", "name": "Superwash", "value": "Yes", "description": "Superwash treated — machine washable on cold cycle, lay flat to dry." },
    { "@type": "PropertyValue", "name": "Vegan", "value": "No", "description": "Contains animal fiber (merino wool)" },
    { "@type": "PropertyValue", "name": "Natural Fiber", "value": "Yes — Animal Fiber" },
    { "@type": "PropertyValue", "name": "Yardage", "value": "440", "unitCode": "YRD", "description": "440 yards (402 meters) per 100g skein" },
    { "@type": "PropertyValue", "name": "Skein Weight", "value": "100", "unitCode": "GRM", "description": "100 gram skein" },
    { "@type": "PropertyValue", "name": "Ply Count", "value": "Single", "description": "Single ply construction — more rustic, softer drape, requires careful handling to avoid splitting" },
    { "@type": "PropertyValue", "name": "Dye Method", "value": "Hand-Dyed — Kettle Dyed", "description": "Kettle-dyed colorway. Tonal variation within skein is expected and desirable." },
    { "@type": "PropertyValue", "name": "Color Name", "value": "Ravelry Red" },
    { "@type": "PropertyValue", "name": "Care Instructions", "value": "Machine wash cold, lay flat to dry. Do not tumble dry.", "description": "Superwash treated for machine washing. High heat will cause felting." },
    { "@type": "PropertyValue", "name": "Recommended Project", "value": "Socks, shawls, lightweight garments, baby items" },
    { "@type": "PropertyValue", "name": "Skill Level", "value": "Intermediate — Advanced" }
  ],
  "offers": {
    "@type": "Offer",
    "price": "16.00",
    "priceCurrency": "USD",
    "availability": "https://schema.org/InStock",
    "url": "https://example-yarn.myshopify.com/products/malabrigo-sock-ravelry-red"
  }
}
</script>

CYC Yarn Weight Reference

Artist Paint Schema — Professional Acrylic Example

Professional art supply buyers filter by pigment code (e.g., PB29 for Ultramarine Blue), lightfastness rating, and transparency — none of which appear in Shopify's default product JSON-LD. This example covers professional-grade acrylic paint with full pigment and lightfastness data.

{
  "@context": "https://schema.org",
  "@type": "Product",
  "name": "Golden Heavy Body Acrylic — Ultramarine Blue (PB29), 2 fl oz Tube",
  "description": "Golden Heavy Body Acrylic Ultramarine Blue, 2 fl oz (59ml) tube. Pigment Blue 29 (PB29). Lightfastness I — Excellent (ASTM D4302). Transparent. High viscosity, retains brush strokes. Professional artist grade.",
  "sku": "GOLDEN-HB-ULT-BLUE-2OZ",
  "brand": { "@type": "Brand", "name": "Golden Artist Colors" },
  "material": "Acrylic polymer emulsion, Pigment Blue 29 (PB29), synthetic thickener",
  "hasCertification": [
    {
      "@type": "Certification",
      "name": "ACMI AP Certified Non-Toxic",
      "issuedBy": {
        "@type": "Organization",
        "name": "Art and Creative Materials Institute (ACMI)",
        "url": "https://acminet.org"
      },
      "url": "https://acminet.org/ap-seal"
    },
    {
      "@type": "Certification",
      "name": "ASTM D4302 Certified — Artist Acrylic Paint",
      "issuedBy": {
        "@type": "Organization",
        "name": "ASTM International",
        "url": "https://www.astm.org"
      },
      "description": "ASTM D4302 certification indicates this paint meets professional artist quality standards for consistency, lightfastness testing, and pigment labeling."
    }
  ],
  "additionalProperty": [
    { "@type": "PropertyValue", "name": "Craft Material Type", "value": "Artist Acrylic Paint" },
    { "@type": "PropertyValue", "name": "Paint Type", "value": "Heavy Body Acrylic", "description": "High-viscosity acrylic. Retains brush and palette knife marks. Suitable for impasto technique." },
    { "@type": "PropertyValue", "name": "Color Name", "value": "Ultramarine Blue" },
    { "@type": "PropertyValue", "name": "Pigment Code", "value": "PB29", "description": "Pigment Blue 29 — Ultramarine Blue (sodium aluminosilicate). Warm-toned, slightly reddish blue. Transparent." },
    { "@type": "PropertyValue", "name": "Pigment Name", "value": "Ultramarine Blue (Pigment Blue 29)" },
    { "@type": "PropertyValue", "name": "Pigment Count", "value": "1", "description": "Single-pigment color. Single-pigment paints allow for more predictable color mixing." },
    { "@type": "PropertyValue", "name": "Lightfastness", "value": "I — Excellent (ASTM)", "description": "ASTM D4302 Lightfastness Rating I — Excellent. Expected to retain color for 100+ years under museum lighting conditions." },
    { "@type": "PropertyValue", "name": "Opacity", "value": "Transparent", "description": "Transparent — allows underpainting to show through. Ideal for glazing, washes, and underpainting techniques." },
    { "@type": "PropertyValue", "name": "Viscosity", "value": "Heavy Body", "description": "High viscosity. Retains brush strokes and texture. Does not self-level." },
    { "@type": "PropertyValue", "name": "Dry Time", "value": "Touch dry in 30-60 minutes. Full cure 1-2 weeks.", "description": "Acrylic drying time depends on layer thickness, ambient humidity, and temperature." },
    { "@type": "PropertyValue", "name": "Artist Grade", "value": "Professional", "description": "Artist quality (professional) grade — higher pigment load, single-pigment colorants, verified lightfastness. Distinct from student/scholastic grade paints." },
    { "@type": "PropertyValue", "name": "Skill Level", "value": "Intermediate — Professional" },
    { "@type": "PropertyValue", "name": "Volume", "value": "59", "unitCode": "MLT", "description": "59ml (2 fl oz) tube" },
    { "@type": "PropertyValue", "name": "ACMI Non-Toxic", "value": "Yes — AP Seal", "description": "ACMI Approved Product (AP) non-toxic certification. Safe for studio use with normal ventilation." }
  ]
}

Children's Craft Kit Schema: ACMI Non-Toxic & Age Safety

Children's art supplies require ACMI AP certification, clear minimum age (as integer for structured filtering), and safety considerations for AI agents answering "safe non-toxic art supplies for a 5-year-old."

{
  "@context": "https://schema.org",
  "@type": "Product",
  "name": "Crayola Washable Watercolor Paint Set — 24 Colors, ACMI Non-Toxic, Ages 3+",
  "description": "Crayola Washable Watercolor Paint Set, 24 vivid colors. Washes from skin and most fabrics. ACMI AP certified non-toxic. Safe for children ages 3 and up. Includes 24 watercolor pans and brush.",
  "sku": "CRAYOLA-WC-24",
  "brand": { "@type": "Brand", "name": "Crayola" },
  "safetyConsideration": "For children 3 years and older. Adult supervision recommended for children under 6. Not for oral consumption.",
  "hasCertification": [
    {
      "@type": "Certification",
      "name": "ACMI AP Certified Non-Toxic",
      "issuedBy": {
        "@type": "Organization",
        "name": "Art and Creative Materials Institute (ACMI)",
        "url": "https://acminet.org"
      }
    }
  ],
  "suggestedAudience": {
    "@type": "PeopleAudience",
    "suggestedMinAge": 3,
    "suggestedMaxAge": 12,
    "audienceType": "Children — Beginner Crafter"
  },
  "additionalProperty": [
    { "@type": "PropertyValue", "name": "Craft Material Type", "value": "Watercolor Paint Set" },
    { "@type": "PropertyValue", "name": "Paint Type", "value": "Washable Watercolor" },
    { "@type": "PropertyValue", "name": "Number of Colors", "value": "24" },
    { "@type": "PropertyValue", "name": "Washable", "value": "Yes", "description": "Washes from skin with soap and water. Washes from most fabrics in cold water." },
    { "@type": "PropertyValue", "name": "ACMI Non-Toxic", "value": "Yes — AP Seal" },
    { "@type": "PropertyValue", "name": "Minimum Age", "value": "3", "description": "Suitable for children ages 3 and older" },
    { "@type": "PropertyValue", "name": "Skill Level", "value": "Beginner — Child" },
    { "@type": "PropertyValue", "name": "Includes", "value": "24 watercolor pans, 1 brush" }
  ]
}

Paint Lightfastness & ASTM Rating Reference

Dawn Liquid Snippet: craft.* Metafield Namespace

Save as snippets/craft-product-schema.liquid. Activates for products tagged yarn, paint, art-supplies, or in the craft-supplies collection.

{% comment %} craft-product-schema.liquid — yarn, paint, art materials schema {% endcomment %}
{% assign is_craft = false %}
{% if product.tags contains 'yarn' or product.tags contains 'paint' or product.tags contains 'art-supplies' or product.tags contains 'craft' %}
  {% assign is_craft = true %}
{% endif %}
{% for collection in product.collections %}
  {% if collection.handle == 'craft-supplies' or collection.handle == 'yarn' or collection.handle == 'art-supplies' or collection.handle == 'paint' %}
    {% assign is_craft = true %}
  {% endif %}
{% endfor %}

{% if is_craft %}
{% assign craft_type   = product.metafields.craft.material_type %}
{% assign yarn_weight  = product.metafields.craft.yarn_weight_cyc %}
{% assign yarn_gauge   = product.metafields.craft.yarn_gauge %}
{% assign fiber_content= product.metafields.craft.fiber_content %}
{% assign yardage      = product.metafields.craft.yardage %}
{% assign skein_weight = product.metafields.craft.skein_weight_grams %}
{% assign superwash    = product.metafields.craft.superwash %}
{% assign is_vegan     = product.metafields.craft.vegan %}
{% assign pigment_code = product.metafields.craft.pigment_code %}
{% assign lightfast    = product.metafields.craft.lightfastness %}
{% assign paint_type   = product.metafields.craft.paint_type %}
{% assign opacity      = product.metafields.craft.opacity %}
{% assign acmi_ap      = product.metafields.craft.acmi_ap_certified %}
{% assign skill_level  = product.metafields.craft.skill_level %}
{% assign min_age      = product.metafields.craft.minimum_age %}

<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 fiber_content != blank %}
  ,"material": {{ fiber_content | json }}
  {% endif %}
  {% if min_age != blank %}
  ,"suggestedAudience": {
    "@type": "PeopleAudience",
    "suggestedMinAge": {{ min_age }},
    "audienceType": {% if skill_level == "Beginner — Child" %}"Children — Beginner Crafter"{% else %}"Crafter — {{ skill_level }}"{% endif %}
  }
  {% endif %}
  {% if acmi_ap == "true" or acmi_ap == true %}
  ,"hasCertification": [
    { "@type": "Certification", "name": "ACMI AP Certified Non-Toxic", "issuedBy": { "@type": "Organization", "name": "Art and Creative Materials Institute (ACMI)", "url": "https://acminet.org" } }
  ]
  {% endif %}
  ,"additionalProperty": [
    {% assign ap_s = false %}
    {% if craft_type != blank %}
    { "@type": "PropertyValue", "name": "Craft Material Type", "value": {{ craft_type | json }} }
    {% assign ap_s = true %}
    {% endif %}
    {% if yarn_weight != blank %}
    {% if ap_s %},{% endif %}{ "@type": "PropertyValue", "name": "Yarn Weight Category", "value": {{ yarn_weight | json }} }
    {% assign ap_s = true %}
    {% endif %}
    {% if yarn_gauge != blank %}
    ,{ "@type": "PropertyValue", "name": "Gauge", "value": {{ yarn_gauge | json }} }
    {% endif %}
    {% if fiber_content != blank %}
    ,{ "@type": "PropertyValue", "name": "Fiber Content", "value": {{ fiber_content | json }} }
    {% endif %}
    {% if yardage != blank %}
    ,{ "@type": "PropertyValue", "name": "Yardage", "value": {{ yardage | json }}, "unitCode": "YRD" }
    {% endif %}
    {% if skein_weight != blank %}
    ,{ "@type": "PropertyValue", "name": "Skein Weight", "value": {{ skein_weight | json }}, "unitCode": "GRM" }
    {% endif %}
    {% if superwash != blank %}
    ,{ "@type": "PropertyValue", "name": "Superwash", "value": {{ superwash | json }} }
    {% endif %}
    {% if is_vegan != blank %}
    ,{ "@type": "PropertyValue", "name": "Vegan", "value": {{ is_vegan | json }} }
    {% endif %}
    {% if paint_type != blank %}
    ,{ "@type": "PropertyValue", "name": "Paint Type", "value": {{ paint_type | json }} }
    {% endif %}
    {% if pigment_code != blank %}
    ,{ "@type": "PropertyValue", "name": "Pigment Code", "value": {{ pigment_code | json }} }
    {% endif %}
    {% if lightfast != blank %}
    ,{ "@type": "PropertyValue", "name": "Lightfastness", "value": {{ lightfast | json }} }
    {% endif %}
    {% if opacity != blank %}
    ,{ "@type": "PropertyValue", "name": "Opacity", "value": {{ opacity | json }} }
    {% endif %}
    {% if skill_level != blank %}
    ,{ "@type": "PropertyValue", "name": "Skill Level", "value": {{ skill_level | json }} }
    {% endif %}
    {% if acmi_ap == "true" or acmi_ap == true %}
    ,{ "@type": "PropertyValue", "name": "ACMI Non-Toxic", "value": "Yes — AP Seal" }
    {% 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 %}

craft.* metafield namespace

5 Common Craft Supply Schema Mistakes

Related Resources

• Shopify Toy & Children's Safety Schema
• Product Safety Certifications Schema
• Shopify Baby & Infant Product Schema
• Shopify Handmade & Artisan Product Schema
• Ecommerce Product Audience Schema
• CatalogScan Blog — AI Shopping Agent Optimization