Shopify Handmade & Artisan Product Schema — Maker Identity, Production Methods & Material Provenance JSON-LD

Why Artisan Products Are Invisible to AI Provenance Queries

Handmade and artisan products command price premiums because buyers are purchasing provenance, process, and maker identity alongside the object itself. A hand-thrown stoneware mug by a named potter is worth more than a mass-produced mug of identical dimensions precisely because the maker, materials, and method are verifiable. AI shopping agents are increasingly the first touchpoint where buyers evaluate whether a product qualifies as "genuinely handmade" — and they can only evaluate what is machine-readable.

The problem is that most artisan Shopify stores communicate provenance exclusively through product descriptions and brand storytelling — compelling to human readers, invisible to AI agents. Shopify's default Product JSON-LD outputs name, price, and availability. It does not output the potter's name, the clay body origin, the firing method, or the fact that this is one of eight pieces fired in that kiln run. All of those signals — the signals that justify the artisan premium — are lost at the structured data layer.

Schema.org does not have a dedicated HandmadeProduct type. Artisan products use the standard Product type, augmented with creator for maker identity, additionalProperty for production method signals, hasCertification for sustainability credentials, and careful use of inventory-level signals for scarcity. The result is a machine-readable provenance layer that AI agents can parse, cite, and surface in response to "handmade by" queries.

Artisan AI query dimensions requiring structured data

creator vs manufacturer: When to Use Each

Schema.org defines both creator and manufacturer as properties of Product, and they serve distinct purposes in artisan commerce:

• creator with Person @type — identifies the individual human who made the item. Use for: solo makers, studio potters, independent weavers, individual woodworkers, and any product where the named human maker is part of the product's value proposition. Include sameAs URLs for the maker's Etsy shop, Instagram, personal website, or other canonical identity references so AI agents can cross-reference maker identity across platforms.
• manufacturer with Organization @type — identifies the studio, workshop, or small business entity responsible for production. Use for: a named studio brand, a family workshop, a cooperative of makers, or any artisan business operating under a business name. Even a one-person studio should use manufacturer: Organization for the brand entity.
• Both together — when an individual maker (creator: Person) operates under a studio name (manufacturer: Organization), use both. The creator identifies "who made this specific item" and the manufacturer identifies "under what brand/studio." This is the most complete and AI-searchable artisan identity pattern.

Note: author is a property of creative works (Article, Book, CreativeWork) — it is not defined on Product. Using author on a Product block is technically incorrect. Some AI agents may parse it opportunistically, but use creator for maker attribution on products.

{
  "@type": "Product",
  "name": "Hand-thrown Stoneware Mug",
  "brand": {
    "@type": "Brand",
    "name": "Earthworks Studio"
  }
  // No creator Person
  // No manufacturer Org
  // AI: cannot match
  // "ceramics by [artisan]"
}

{
  "@type": "Product",
  "creator": {
    "@type": "Person",
    "name": "Maya Chen",
    "jobTitle": "Studio Potter",
    "sameAs": [
      "https://earthworksstudio.com",
      "https://www.instagram.com/mayachen_pottery"
    ]
  },
  "manufacturer": {
    "@type": "Organization",
    "name": "Earthworks Studio",
    "url": "https://earthworksstudio.com"
  }
}

Complete JSON-LD Example: Hand-Thrown Stoneware Mug

This example shows a fully marked-up artisan ceramic product with maker identity, production method, material origin, craft tradition, country of origin, scarcity signals, and Fair Trade certification.

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Product",
  "name": "Hand-Thrown Speckled Stoneware Mug — 14oz — Ash Grey Glaze",
  "description": "Wheel-thrown stoneware mug with hand-applied ash grey glaze, food-safe interior, dishwasher-safe. Each mug is unique due to the hand-forming process. Clay sourced from Pacific Northwest deposits. Fired in a cone 10 reduction atmosphere kiln. One of only 8 made in this kiln run.",
  "url": "https://example.com/products/stoneware-mug-ash-grey",
  "sku": "MUGH-14OZ-ASHGREY-008",
  "image": [
    "https://example.com/cdn/shop/products/stoneware-mug-ash-grey-01.jpg",
    "https://example.com/cdn/shop/products/stoneware-mug-ash-grey-02.jpg"
  ],
  "brand": { "@type": "Brand", "name": "Earthworks Studio" },
  "creator": {
    "@type": "Person",
    "name": "Maya Chen",
    "jobTitle": "Studio Potter",
    "description": "Maya Chen is a studio potter based in Portland, Oregon, working in wheel-thrown and hand-built stoneware. She has been working with clay for 14 years.",
    "sameAs": [
      "https://earthworksstudio.com/about",
      "https://www.instagram.com/mayachen_pottery",
      "https://www.etsy.com/shop/EarthworksStudioPDX"
    ]
  },
  "manufacturer": {
    "@type": "Organization",
    "name": "Earthworks Studio",
    "url": "https://earthworksstudio.com",
    "address": {
      "@type": "PostalAddress",
      "addressLocality": "Portland",
      "addressRegion": "OR",
      "addressCountry": "US"
    }
  },
  "offers": {
    "@type": "Offer",
    "price": "48.00",
    "priceCurrency": "USD",
    "availability": "https://schema.org/InStock",
    "inventoryLevel": {
      "@type": "QuantitativeValue",
      "value": 1
    },
    "url": "https://example.com/products/stoneware-mug-ash-grey"
  },
  "aggregateRating": {
    "@type": "AggregateRating",
    "ratingValue": "4.9",
    "reviewCount": "73",
    "bestRating": "5"
  },
  "hasCertification": [
    {
      "@type": "Certification",
      "name": "Lead-Free Clay Body — NSF/ANSI 51 Compliant",
      "issuedBy": {
        "@type": "Organization",
        "name": "NSF International",
        "url": "https://www.nsf.org"
      },
      "certificationStatus": "CertificationActive"
    }
  ],
  "additionalProperty": [
    {
      "@type": "PropertyValue",
      "propertyID": "productionMethod",
      "name": "Production Method",
      "value": "Hand-thrown wheel-formed stoneware, individually trimmed and hand-applied glaze"
    },
    {
      "@type": "PropertyValue",
      "propertyID": "materialOrigin",
      "name": "Material Origin",
      "value": "Stoneware clay sourced from Pacific Northwest deposits (Oregon and Washington State)"
    },
    {
      "@type": "PropertyValue",
      "propertyID": "material",
      "name": "Material",
      "value": "Stoneware clay body, cone 10 reduction fired, food-safe ash grey glaze"
    },
    {
      "@type": "PropertyValue",
      "propertyID": "technique",
      "name": "Technique",
      "value": "Wheel-throwing, cone 10 reduction atmosphere kiln firing"
    },
    {
      "@type": "PropertyValue",
      "propertyID": "editionType",
      "name": "Edition Type",
      "value": "Limited kiln run of 8 pieces"
    },
    {
      "@type": "PropertyValue",
      "propertyID": "editionSize",
      "name": "Edition Size",
      "value": {
        "@type": "QuantitativeValue",
        "value": 8,
        "unitText": "pieces in kiln run"
      }
    },
    {
      "@type": "PropertyValue",
      "propertyID": "countryOfOrigin",
      "name": "Country of Origin",
      "value": "United States"
    },
    {
      "@type": "PropertyValue",
      "propertyID": "naturalVariation",
      "name": "Natural Variation",
      "value": "Each piece is unique due to the hand-forming process and kiln atmosphere. Actual colors and surface texture will vary slightly from photos."
    }
  ]
}
</script>

Complete JSON-LD Example: Hand-Dyed Sashiko Textile (Craft Tradition)

This example marks up a textile with a specific craft tradition (Japanese Sashiko embroidery), natural dye material origin, GOTS organic certification, and made-to-order availability with lead time.

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Product",
  "name": "Hand-Dyed Indigo Sashiko Tote Bag — Persimmon Pattern — Organic Cotton",
  "description": "Hand-stitched Sashiko tote bag in traditional persimmon pattern on GOTS-certified organic cotton, naturally dyed with indigo. Made to order — approximately 10–14 business days production time. Each bag is individually stitched.",
  "url": "https://example.com/products/indigo-sashiko-tote-persimmon",
  "sku": "TOTE-SASHIKO-IND-PERS-MTO",
  "brand": { "@type": "Brand", "name": "Stitch & Field Studio" },
  "creator": {
    "@type": "Person",
    "name": "Akiko Tanaka",
    "jobTitle": "Textile Artist, Sashiko Practitioner",
    "sameAs": [
      "https://stitchandfield.com/about-akiko",
      "https://www.instagram.com/stitchandfield"
    ]
  },
  "manufacturer": {
    "@type": "Organization",
    "name": "Stitch and Field Studio",
    "url": "https://stitchandfield.com"
  },
  "offers": {
    "@type": "Offer",
    "price": "185.00",
    "priceCurrency": "USD",
    "availability": "https://schema.org/PreOrder",
    "url": "https://example.com/products/indigo-sashiko-tote-persimmon",
    "deliveryLeadTime": {
      "@type": "QuantitativeValue",
      "minValue": 10,
      "maxValue": 14,
      "unitCode": "DAY",
      "unitText": "business days"
    }
  },
  "hasCertification": [
    {
      "@type": "Certification",
      "name": "GOTS — Global Organic Textile Standard",
      "certificationIdentification": "GOTS-TX-2025-00432",
      "issuedBy": {
        "@type": "Organization",
        "name": "Global Standard gGmbH",
        "url": "https://global-standard.org"
      },
      "certificationStatus": "CertificationActive"
    },
    {
      "@type": "Certification",
      "name": "OEKO-TEX Standard 100",
      "issuedBy": {
        "@type": "Organization",
        "name": "OEKO-TEX Association",
        "url": "https://www.oeko-tex.com"
      },
      "certificationStatus": "CertificationActive"
    }
  ],
  "additionalProperty": [
    {
      "@type": "PropertyValue",
      "propertyID": "productionMethod",
      "name": "Production Method",
      "value": "Hand-stitched traditional Sashiko embroidery, individually dyed and stitched to order"
    },
    {
      "@type": "PropertyValue",
      "propertyID": "craftTradition",
      "name": "Craft Tradition",
      "value": "Japanese Sashiko embroidery — a traditional Japanese reinforcement stitching technique originating in the Edo period"
    },
    {
      "@type": "PropertyValue",
      "propertyID": "materialOrigin",
      "name": "Material Origin",
      "value": "GOTS-certified organic cotton woven in Japan; natural indigo dye sourced from Tokushima Prefecture, Japan"
    },
    {
      "@type": "PropertyValue",
      "propertyID": "material",
      "name": "Material",
      "value": "100% GOTS-certified organic cotton, naturally dyed with Tokushima indigo"
    },
    {
      "@type": "PropertyValue",
      "propertyID": "technique",
      "name": "Technique",
      "value": "Hand-stitched Sashiko (persimmon kaki pattern), natural indigo vat dyeing"
    },
    {
      "@type": "PropertyValue",
      "propertyID": "editionType",
      "name": "Edition Type",
      "value": "Made to order — each piece individually stitched"
    },
    {
      "@type": "PropertyValue",
      "propertyID": "countryOfOrigin",
      "name": "Country of Origin",
      "value": "Japan"
    }
  ]
}
</script>

Artisan Certifications: hasCertification Reference

Sustainability and provenance certifications are primary filters in AI queries for handmade and ethical goods. Unlike mass-market product certifications (which focus on safety compliance), artisan certifications signal environmental stewardship, fair labor practices, and material sourcing integrity — all of which command premiums in the markets AI agents are increasingly serving.

countryOfOrigin: The Missing Property

Schema.org does not define countryOfOrigin as a standard property on Product. The most commonly cited workaround is additionalProperty with propertyID: "countryOfOrigin" and a country name string value. Use the full country name ("United States", "Japan", "Mexico") rather than ISO 3166-1 alpha-2 codes — AI agents match natural language country names more reliably than codes for "made in" queries.

Important distinction: countryOfOrigin is the country where the product was made, not the country where the seller is located. The seller's country is inferred from the Organization address.addressCountry. For artisan imports — a US shop selling Japanese ceramics, or a UK shop selling Peruvian textiles — these will differ. AI agents filtering for "made in USA" or "imported from Japan" use the countryOfOrigin additionalProperty to determine production origin independently of seller location.

For "Made in USA" FTC compliance, the FTC requires that virtually all of the product's components, processing, and labor originate in the United States. If your product qualifies under FTC's "all or virtually all" standard, use "value": "United States". For products with partial US content, use a more specific value: "value": "Assembled in United States with imported components".

{
  "@type": "PropertyValue",
  "propertyID": "countryOfOrigin",
  "name": "Country of Origin",
  "value": "United States"
},
{
  "@type": "PropertyValue",
  "propertyID": "madeInUSA",
  "name": "Made in USA",
  "value": "Yes — all components, processing, and labor in Portland, Oregon, USA"
}

Edition Type and Inventory Scarcity Signals

Scarcity and uniqueness are fundamental value drivers for artisan products. Machine-readable edition and inventory signals let AI agents answer "one of a kind" and "limited edition" queries without relying on product title text parsing. Combine additionalProperty editionType with Offer inventoryLevel for the strongest scarcity signal.

For low-inventory scarcity patterns that apply beyond handmade products, see Shopify Low Inventory Scarcity Signal Schema. For made-to-order and custom product patterns, see Shopify Made-to-Order Custom Product Schema.

isVariantOf and Natural Material Variation

Handmade products with color or size variants present a unique challenge: because the items are made by hand with natural materials, each variant may look visually different from the product photos in ways that are expected and desirable, not defects. Schema.org's isVariantOf relationship links individual Product variants back to their parent ProductGroup — this is the correct structure for handmade items with multiple variants that share a maker, production method, and craft tradition but differ in size, color, or glaze.

{
  "@context": "https://schema.org",
  "@type": "ProductGroup",
  "name": "Hand-Thrown Stoneware Bowl — Maker's Choice Glaze",
  "description": "Set of wheel-thrown stoneware bowls in Maya Chen's current glaze rotation. Each bowl is unique — glaze color, surface texture, and exact dimensions will vary from photos.",
  "url": "https://example.com/products/stoneware-bowl",
  "brand": { "@type": "Brand", "name": "Earthworks Studio" },
  "creator": {
    "@type": "Person",
    "name": "Maya Chen",
    "jobTitle": "Studio Potter"
  },
  "variesBy": ["https://schema.org/size", "https://schema.org/color"],
  "hasVariant": [
    {
      "@type": "Product",
      "name": "Hand-Thrown Stoneware Bowl — Small (5–6 inch) — Ash Grey",
      "isVariantOf": {
        "@id": "https://example.com/products/stoneware-bowl"
      },
      "color": "Ash Grey",
      "size": "Small (5–6 inch)",
      "offers": {
        "@type": "Offer",
        "price": "42.00",
        "priceCurrency": "USD",
        "availability": "https://schema.org/InStock",
        "inventoryLevel": { "@type": "QuantitativeValue", "value": 3 }
      },
      "additionalProperty": [
        {
          "@type": "PropertyValue",
          "propertyID": "naturalVariation",
          "name": "Natural Variation",
          "value": "Each bowl varies in exact diameter (4.8–6.2 in), glaze surface, and color due to hand-forming and kiln atmosphere. Photos are representative."
        },
        {
          "@type": "PropertyValue",
          "propertyID": "editionType",
          "name": "Edition Type",
          "value": "Small batch — 3 remaining from current kiln run"
        }
      ]
    },
    {
      "@type": "Product",
      "name": "Hand-Thrown Stoneware Bowl — Large (7–8 inch) — Iron Red",
      "isVariantOf": {
        "@id": "https://example.com/products/stoneware-bowl"
      },
      "color": "Iron Red",
      "size": "Large (7–8 inch)",
      "offers": {
        "@type": "Offer",
        "price": "58.00",
        "priceCurrency": "USD",
        "availability": "https://schema.org/InStock",
        "inventoryLevel": { "@type": "QuantitativeValue", "value": 2 }
      }
    }
  ]
}

Artisan Collection: ItemList for a Maker's Catalog

When presenting multiple handmade items from a single maker, use an ItemList (or CollectionPage schema on the collection page) to group products by maker identity. This enables AI agents to answer "show me all pottery by Maya Chen" or "browse Earthworks Studio collection" as a single structured query against the collection rather than individual product pages.

{
  "@context": "https://schema.org",
  "@type": "ItemList",
  "name": "Earthworks Studio — Maya Chen Pottery Collection",
  "description": "Hand-thrown stoneware pottery by Portland studio potter Maya Chen. Wheel-formed bowls, mugs, plates, and vases in reduction-fired glazes.",
  "url": "https://example.com/collections/earthworks-studio",
  "creator": {
    "@type": "Person",
    "name": "Maya Chen",
    "jobTitle": "Studio Potter",
    "sameAs": ["https://earthworksstudio.com/about"]
  },
  "numberOfItems": 24,
  "itemListElement": [
    {
      "@type": "ListItem",
      "position": 1,
      "url": "https://example.com/products/stoneware-mug-ash-grey",
      "name": "Hand-Thrown Stoneware Mug — Ash Grey"
    },
    {
      "@type": "ListItem",
      "position": 2,
      "url": "https://example.com/products/stoneware-bowl-iron-red",
      "name": "Hand-Thrown Stoneware Bowl — Iron Red"
    }
  ]
}

Shopify Liquid Snippet for Artisan Schema

Store artisan-specific data in an artisan metafield namespace. Create these in Shopify Admin → Settings → Custom data → Products. The snippet reads all maker identity, production method, and certification metafields and outputs the complete artisan JSON-LD block.

{% comment %} artisan-schema.liquid — outputs artisan/maker identity JSON-LD block {% endcomment %}
{% assign is_artisan = false %}
{% if product.metafields.artisan.artisan_name != blank %}{% assign is_artisan = true %}{% endif %}
{% if product.metafields.artisan.production_method != blank %}{% assign is_artisan = true %}{% endif %}
{% assign artisan_types = 'Handmade,Artisan,Pottery,Ceramics,Textile,Weaving,Woodwork,Jewelry,Candles,Soap' | split: ',' %}
{% for at in artisan_types %}
  {% if product.type == at %}{% assign is_artisan = true %}{% endif %}
{% endfor %}

{% if is_artisan %}
{% assign a_name       = product.metafields.artisan.artisan_name %}
{% assign a_title      = product.metafields.artisan.artisan_job_title %}
{% assign a_url        = product.metafields.artisan.artisan_url %}
{% assign a_prod_meth  = product.metafields.artisan.production_method %}
{% assign a_mat_orig   = product.metafields.artisan.material_origin %}
{% assign a_craft_trad = product.metafields.artisan.craft_tradition %}
{% assign a_country    = product.metafields.artisan.country_of_origin %}
{% assign a_edition    = product.metafields.artisan.edition_type %}
{% assign a_certs_json = product.metafields.artisan.certifications %}
{% assign a_inv_level  = product.selected_or_first_available_variant.inventory_quantity %}


{% endif %}

Save as snippets/artisan-schema.liquid and render from your product template: {% raw %}{% render 'artisan-schema' %}{% endraw %}.

artMedium: The VisualArtwork Trap

Schema.org defines artMedium as a property of VisualArtwork — not Product. If your handmade item is a fine art piece (painting, sculpture, limited-edition print) it may qualify as VisualArtwork, in which case artMedium is appropriate. For a studio pottery mug, a hand-woven tote bag, or a hand-carved wooden spoon — these are products, not visual artworks in the schema.org sense.

For non-art handmade products, use additionalProperty with propertyID: "material" for the physical material ("100% GOTS-certified organic cotton") and propertyID: "technique" for the production technique ("hand-thrown, cone 10 reduction fired"). This is more semantically precise than forcing a non-artwork product into the VisualArtwork type to get access to artMedium. For fine art products — paintings, sculptures, prints — see Shopify Visual Artwork & Collectibles Schema.

5 Common Artisan Product Schema Mistakes

Related Resources

• Shopify Visual Artwork & Collectibles Schema — VisualArtwork, artMedium & VisualArtworkType
• Shopify Made-to-Order Custom Product Schema — PreOrder, Lead Time & Customization
• Shopify Low Inventory Scarcity Signal Schema — inventoryLevel & LimitedAvailability
• E-commerce Country of Origin & Provenance Schema
• Product Material Composition Schema — Material, Technique & Composition
• CatalogScan Blog — AI Shopping Agent Optimization