Shopify Cosmetics & Beauty Product Schema — INCI Ingredients, Skin Type & Certifications JSON-LD

Why Beauty Brands Are Invisible to AI Shopping Queries

Beauty AI queries are structurally multi-dimensional. A single product search — "SPF 30 moisturizer for oily skin fragrance-free" — contains four simultaneous filter criteria: SPF value, skin type compatibility, fragrance status, and product category. Answering it requires machine-readable data for all four dimensions simultaneously. Shopify's default JSON-LD outputs only name, price, availability, and brand — none of the beauty-specific signals.

The result is systematic exclusion. When ChatGPT Shopping, Perplexity Shopping, or Google AI Mode filters by skin type or certification, every beauty product without structured skin type data is eliminated from consideration regardless of how well the product would actually match. The exclusion is not because your product doesn't qualify — it's because the AI agent has no machine-readable signal to include it.

Schema.org has no dedicated beauty product type (unlike DietarySupplement for supplements or Vehicle for auto). The solution is a disciplined additionalProperty architecture on the standard Product type — using consistent, predictable property IDs and values that map to the dimensions AI beauty queries use for filtering.

Beauty AI query dimensions requiring structured data

Beauty additionalProperty Architecture

Use additionalProperty arrays on the Product block to encode every beauty-specific signal. Each entry is a PropertyValue object with a consistent propertyID (the machine-readable key AI agents use for filtering) and a name / value pair for human-readable display.

Core additionalProperty values for skincare

Core additionalProperty values for colour cosmetics (makeup)

Complete JSON-LD Example: Niacinamide Serum (Skincare)

This example shows a fully marked-up skincare product — a niacinamide serum — with INCI ingredients, key active ingredients, skin type/concern targeting, and cruelty-free certification.

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Product",
  "name": "10% Niacinamide + 1% Zinc Pore Minimizing Serum — 30ml",
  "description": "High-strength niacinamide serum with zinc for visibly reduced pores, balanced sebum production, and smoother skin texture. Fragrance-free, vegan, Leaping Bunny certified.",
  "url": "https://example.com/products/niacinamide-serum",
  "sku": "SKIN-NIA-30",
  "gtin13": "1234567890123",
  "image": [
    "https://example.com/cdn/shop/products/niacinamide-serum-front.jpg",
    "https://example.com/cdn/shop/products/niacinamide-serum-texture.jpg"
  ],
  "brand": { "@type": "Brand", "name": "ClearLab Skincare" },
  "offers": {
    "@type": "Offer",
    "price": "24.00",
    "priceCurrency": "USD",
    "availability": "https://schema.org/InStock",
    "url": "https://example.com/products/niacinamide-serum"
  },
  "aggregateRating": {
    "@type": "AggregateRating",
    "ratingValue": "4.7",
    "reviewCount": "1284",
    "bestRating": "5"
  },
  "hasCertification": [
    {
      "@type": "Certification",
      "name": "Leaping Bunny Certified",
      "certificationIdentification": "LB-2025-08843",
      "issuedBy": {
        "@type": "Organization",
        "name": "Cruelty Free International",
        "url": "https://www.crueltyfreeinternational.org"
      },
      "certificationStatus": "CertificationActive"
    },
    {
      "@type": "Certification",
      "name": "Certified Vegan",
      "issuedBy": {
        "@type": "Organization",
        "name": "Vegan Action",
        "url": "https://vegan.org"
      },
      "certificationStatus": "CertificationActive"
    }
  ],
  "additionalProperty": [
    {
      "@type": "PropertyValue",
      "propertyID": "skinType",
      "name": "Skin Type",
      "value": "Oily, Combination, Normal"
    },
    {
      "@type": "PropertyValue",
      "propertyID": "skinConcern",
      "name": "Skin Concern",
      "value": "Pores, Excess Sebum, Uneven Texture, Hyperpigmentation"
    },
    {
      "@type": "PropertyValue",
      "propertyID": "activeIngredient",
      "name": "Key Ingredient",
      "value": "Niacinamide 10%"
    },
    {
      "@type": "PropertyValue",
      "propertyID": "activeIngredient",
      "name": "Key Ingredient",
      "value": "Zinc PCA 1%"
    },
    {
      "@type": "PropertyValue",
      "propertyID": "ingredientList",
      "name": "Full Ingredients (INCI)",
      "value": "Aqua, Niacinamide, Zinc PCA, Dimethyl Isosorbide, Tamarindus Indica Seed Gum, Xanthan Gum, Isoceteth-20, Pentylene Glycol, Sodium Hydroxide, Ethylhexylglycerin, Phenoxyethanol"
    },
    {
      "@type": "PropertyValue",
      "propertyID": "formulaType",
      "name": "Formula Type",
      "value": "Water-based serum"
    },
    {
      "@type": "PropertyValue",
      "propertyID": "fragranceFree",
      "name": "Fragrance Free",
      "value": "Yes"
    },
    {
      "@type": "PropertyValue",
      "propertyID": "alcoholFree",
      "name": "Alcohol Free",
      "value": "Yes"
    },
    {
      "@type": "PropertyValue",
      "propertyID": "parabenFree",
      "name": "Paraben Free",
      "value": "Yes"
    },
    {
      "@type": "PropertyValue",
      "propertyID": "certificationStatus",
      "name": "Ethical Credentials",
      "value": "Cruelty-Free, Vegan"
    },
    {
      "@type": "PropertyValue",
      "propertyID": "productSize",
      "name": "Size",
      "value": "30ml / 1 fl oz"
    }
  ]
}
</script>

Complete JSON-LD Example: Tinted SPF Moisturizer (Skincare + Makeup)

SPF products sold in the US that make sun protection claims are regulated as drugs by the FDA. This affects schema: add legalDisclaimer with the required drug facts notice, and use additionalProperty for SPF value with a QuantitativeValue.

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Product",
  "name": "Tinted Moisturizer SPF 40 — Shade 3N (Medium Neutral) — 40ml",
  "description": "Lightweight tinted moisturizer with SPF 40 broad-spectrum protection, buildable light coverage, and a natural satin finish. Mineral UV filters. Fragrance-free. Reef-safe formula.",
  "url": "https://example.com/products/tinted-moisturizer-spf40-3n",
  "sku": "TM-SPF40-3N",
  "color": "Medium Neutral",
  "brand": { "@type": "Brand", "name": "BareSun Beauty" },
  "offers": {
    "@type": "Offer",
    "price": "38.00",
    "priceCurrency": "USD",
    "availability": "https://schema.org/InStock"
  },
  "legalDisclaimer": "Drug Facts: Active ingredient: Zinc Oxide 15% (Sunscreen). Uses: Helps prevent sunburn. If used as directed with other sun protection measures, decreases the risk of skin cancer and early skin aging caused by the sun. Warnings: For external use only. When using this product keep out of eyes. Stop use and ask a doctor if rash occurs. Keep out of reach of children.",
  "additionalProperty": [
    {
      "@type": "PropertyValue",
      "propertyID": "spf",
      "name": "SPF",
      "value": {
        "@type": "QuantitativeValue",
        "value": 40,
        "unitCode": "P1",
        "unitText": "SPF"
      }
    },
    {
      "@type": "PropertyValue",
      "propertyID": "uvProtection",
      "name": "UV Protection",
      "value": "Broad Spectrum UVA/UVB"
    },
    {
      "@type": "PropertyValue",
      "propertyID": "sunscreenType",
      "name": "Sunscreen Type",
      "value": "Mineral (Zinc Oxide)"
    },
    {
      "@type": "PropertyValue",
      "propertyID": "reefSafe",
      "name": "Reef Safe",
      "value": "Yes — no oxybenzone or octinoxate"
    },
    {
      "@type": "PropertyValue",
      "propertyID": "skinType",
      "name": "Skin Type",
      "value": "All Skin Types"
    },
    {
      "@type": "PropertyValue",
      "propertyID": "coverageLevel",
      "name": "Coverage",
      "value": "Light to Medium (buildable)"
    },
    {
      "@type": "PropertyValue",
      "propertyID": "finishType",
      "name": "Finish",
      "value": "Natural Satin"
    },
    {
      "@type": "PropertyValue",
      "propertyID": "shadeFamily",
      "name": "Shade Family",
      "value": "Neutral"
    },
    {
      "@type": "PropertyValue",
      "propertyID": "undertone",
      "name": "Undertone",
      "value": "Neutral"
    },
    {
      "@type": "PropertyValue",
      "propertyID": "fragranceFree",
      "name": "Fragrance Free",
      "value": "Yes"
    }
  ]
}
</script>

Beauty Certifications in Structured Data

Certifications are primary filters in beauty AI queries. Use hasCertification for the three most query-frequent beauty credential types:

{
  "@type": "Product",
  "name": "Vegan Serum",
  "description": "Certified vegan
    and cruelty-free serum."
  // No hasCertification
  // No additionalProperty
  // AI: cannot verify claim
}

{
  "@type": "Product",
  "hasCertification": [{
    "@type": "Certification",
    "name": "Leaping Bunny Certified",
    "issuedBy": {
      "name": "Cruelty Free International"
    }
  },{
    "@type": "Certification",
    "name": "Certified Vegan",
    "issuedBy": { "name": "Vegan Action" }
  }]
}

Shopify Metafield Architecture for Beauty

Store beauty-specific data in a beauty metafield namespace. Create these in Shopify Admin → Settings → Custom data → Products before building the Liquid snippet. The architecture below covers both skincare and colour cosmetics.

Shopify Liquid Snippet

This snippet outputs the full beauty-schema Product JSON-LD block from beauty.* metafields. Gate it on the product type to avoid outputting beauty-specific properties on non-beauty products.

{% comment %} beauty-schema.liquid — outputs beauty additionalProperty JSON-LD {% endcomment %}
{% assign is_beauty = false %}
{% if product.type == 'Skincare' or product.type == 'Makeup' or product.type == 'Sunscreen'
    or product.type == 'Foundation' or product.type == 'Serum' or product.type == 'Moisturizer' %}
  {% assign is_beauty = true %}
{% endif %}
{% if product.metafields.beauty.skin_type != blank %}
  {% assign is_beauty = true %}
{% endif %}

{% if is_beauty %}
{% assign b_skin_type   = product.metafields.beauty.skin_type %}
{% assign b_skin_concern = product.metafields.beauty.skin_concern %}
{% assign b_inci        = product.metafields.beauty.inci_list %}
{% assign b_spf         = product.metafields.beauty.spf %}
{% assign b_ff          = product.metafields.beauty.fragrance_free %}
{% assign b_disclaimer  = product.metafields.beauty.legal_disclaimer %}
{% assign b_certs_json  = product.metafields.beauty.certifications %}
{% assign b_shade_fam   = product.metafields.beauty.shade_family %}
{% assign b_undertone   = product.metafields.beauty.undertone %}
{% assign b_coverage    = product.metafields.beauty.coverage_level %}
{% assign b_finish      = product.metafields.beauty.finish_type %}
{% assign b_actives_raw = product.metafields.beauty.active_ingredients %}


{% endif %}

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

Common Beauty Schema Mistakes

Related Resources

• Shopify Dietary Supplement Schema — DietarySupplement JSON-LD for Health & Wellness Stores
• Product Safety Certifications Schema — NSF, USP, FDA, CE in JSON-LD
• Shopify ProductGroup hasVariant Schema — Multi-Variant Structured Data
• Shopify Schema Markup Guide — Complete JSON-LD Reference
• E-commerce AI Readiness Checklist
• CatalogScan Blog — AI Shopping Agent Optimization