Source of truth for implementation is the canonical schema host: https://schemas.meta-aiml.org/v3.0.0/. If any page text conflicts with canonical schema files, follow canonical files. Documentation home.

Product

v3.0.0

ProductEntity

Commerce

v3 schema for standalone product artifacts represented as ProductEntity without interaction archetypes, covering physical or digital sellable items and inventory lifecycle.

Top-level required

Required modules

Capability groups

Entity properties

Canonical Files

Contract URL: https://schemas.meta-aiml.org/v3.0.0/entity/product.json

Example URL: https://schemas.meta-aiml.org/v3.0.0/examples/product_example_schema_v3.json

Inheritance Chain

https://schemas.meta-aiml.org/v3.0.0/ontology/product_entity.json

Interaction archetype

No interaction archetype (ProductEntity exception).

Required Top-level Fields

These fields are enforced by JSON Schema required[] at root level.

@type

ontologicalMode

domain

name

description

deliveryFormat

productType

inventory

capabilities

structuralMetadata

modules

Non-universal required fields

productType

inventory

Entity-specific Properties

Keys under properties.properties dedicated to this entity contract.

barcode

brand

productCategory

shelfLifeDays

sku

warrantyMonths

Modules Contract

Required modules

No required modules for this entity.

Optional modules

compliance

fulfillment

lifecycle

Capabilities Contract

Required capability groups

No required capability groups for this entity.

Optional capability groups

commerce

content

financial

Governance Validation Rules

Normative rule list from governanceMetadata.sdkValidationRules.

RULE-PROD-001: @type MUST equal "Product"

RULE-PROD-002: ontologicalMode MUST equal "ProductEntity"

RULE-PROD-003: interactionArchetype MUST NOT be present

RULE-PROD-004: productType and inventory MUST be present

RULE-PROD-005: allOf MUST reference only product_entity ontology

RULE-PROD-006: inventory.availableQuantity and inventory.stockStatus MUST be present

Canonical Contract JSON

https://schemas.meta-aiml.org/v3.0.0/entity/product.json

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "@context": [
    "https://schemas.meta-aiml.org/v3.0.0/context.jsonld"
  ],
  "@id": "https://schemas.meta-aiml.org/v3.0.0/entity/product.json",
  "$id": "https://schemas.meta-aiml.org/v3.0.0/entity/product.json",
  "@type": "Product",
  "schemaVersion": "3.0.0",
  "aimlVersion": "3.0.0",
  "title": "Product Entity Schema",
  "description": "v3 schema for standalone product artifacts represented as ProductEntity without interaction archetypes, covering physical or digital sellable items and inventory lifecycle.",
  "examples": [
    {
      "description": "Consumer electronic product with stock tracking and warranty attributes",
      "reference": "product_example_electronics"
    },
    {
      "description": "Packaged physical good with shelf-life and compliance metadata",
      "reference": "product_example_packaged_goods"
    }
  ],
  "type": "object",
  "additionalProperties": false,
  "allOf": [
    {
      "$ref": "../ontology/product_entity.json"
    }
  ],
  "properties": {
    "@type": {
      "const": "Product"
    },
    "ontologicalMode": {
      "const": "ProductEntity"
    },
    "domain": {
      "const": "Commerce"
    },
    "businessModel": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "Transactional",
          "Wholesale",
          "Subscription"
        ]
      }
    },
    "deliveryFormat": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "PhysicalGoods",
          "DigitalDownload",
          "LicenseKeyDelivery"
        ]
      }
    },
    "name": {
      "$ref": "../components/multilingual_format.json#/$defs/LocalizedText"
    },
    "description": {
      "$ref": "../components/multilingual_format.json#/$defs/LocalizedText"
    },
    "shortDescription": {
      "type": "string"
    },
    "url": {
      "type": "string",
      "format": "uri"
    },
    "foundingDate": {
      "type": "string",
      "format": "date"
    },
    "productType": {
      "type": "string",
      "enum": [
        "physical",
        "digital",
        "hybrid"
      ]
    },
    "inventory": {
      "type": "object",
      "required": [
        "availableQuantity",
        "stockStatus"
      ],
      "properties": {
        "availableQuantity": {
          "type": "integer",
          "minimum": 0
        },
        "stockStatus": {
          "type": "string",
          "enum": [
            "in_stock",
            "out_of_stock",
            "backorder",
            "discontinued"
          ]
        },
        "reorderPoint": {
          "type": "integer",
          "minimum": 0
        },
        "warehouseLocations": {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      }
    },
    "properties": {
      "type": "object",
      "properties": {
        "productCategory": {
          "type": "string"
        },
        "brand": {
          "type": "string"
        },
        "sku": {
          "type": "string"
        },
        "barcode": {
          "type": "string"
        },
        "warrantyMonths": {
          "type": "integer",
          "minimum": 0
        },
        "shelfLifeDays": {
          "type": "integer",
          "minimum": 0
        }
      }
    },
    "capabilities": {
      "type": "object",
      "properties": {
        "commerce": {
          "$ref": "../components/capability_groups.json#/$defs/CommerceCapabilities"
        },
        "financial": {
          "$ref": "../components/capability_groups.json#/$defs/FinancialCapabilities"
        },
        "content": {
          "$ref": "../components/capability_groups.json#/$defs/ContentCapabilities"
        }
      }
    },
    "modules": {
      "type": "object",
      "properties": {
        "lifecycle": {
          "type": "object",
          "properties": {
            "supportsVersioning": {
              "type": "boolean"
            },
            "replacementPolicy": {
              "type": "string"
            },
            "endOfLifeDate": {
              "type": "string",
              "format": "date"
            }
          }
        },
        "fulfillment": {
          "type": "object",
          "properties": {
            "leadTimeDays": {
              "type": "integer",
              "minimum": 0
            },
            "returnWindowDays": {
              "type": "integer",
              "minimum": 0
            },
            "supportsDropShipping": {
              "type": "boolean"
            }
          }
        },
        "compliance": {
          "type": "object",
          "properties": {
            "certifications": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "hazmatClassification": {
              "type": "string"
            },
            "countryRestrictions": {
              "type": "array",
              "items": {
                "type": "string"
              }
            }
          }
        }
      }
    },
    "structuralMetadata": {
      "type": "object",
      "properties": {
        "entityNature": {
          "const": "product_item"
        },
        "distributionModel": {
          "type": "string",
          "enum": [
            "physical_distribution",
            "digital_distribution",
            "hybrid"
          ]
        },
        "versioningModel": {
          "type": "string",
          "enum": [
            "none",
            "semantic_versioning",
            "calendar_versioning",
            "custom"
          ]
        },
        "contentOwnership": {
          "const": "platform"
        }
      }
    },
    "targetAudience": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "siteCapabilities": {
      "type": "object",
      "properties": {
        "supportedDevices": {
          "type": "array",
          "items": {
            "type": "string",
            "enum": [
              "desktop",
              "mobile",
              "tablet"
            ]
          }
        },
        "languages": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "accessibilityFeatures": {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      }
    }
  },
  "required": [
    "@type",
    "ontologicalMode",
    "domain",
    "name",
    "description",
    "deliveryFormat",
    "productType",
    "inventory",
    "capabilities",
    "structuralMetadata",
    "modules"
  ],
  "validationMetadata": {
    "schemaVersion": "3.0.0",
    "phase": "entity",
    "status": "draft",
    "lastValidated": "2026-02-20T12:00:00Z",
    "validator": "META-AIML QA"
  },
  "semanticAnnotations": {
    "classificationRationale": "Product is modeled as ProductEntity because the schema describes the product artifact itself (type, inventory, lifecycle) rather than an interaction platform.",
    "disambiguationNotes": "ProductEntity intentionally does not declare interactionArchetype. Service behavior belongs to separate platform entities such as ecommerce_store or marketplace."
  },
  "governanceMetadata": {
    "entityVersion": "3.0.0",
    "introducedIn": "META-AIML v3.0.0",
    "stabilityLevel": "draft",
    "sdkValidationRules": [
      "RULE-PROD-001: @type MUST equal \"Product\"",
      "RULE-PROD-002: ontologicalMode MUST equal \"ProductEntity\"",
      "RULE-PROD-003: interactionArchetype MUST NOT be present",
      "RULE-PROD-004: productType and inventory MUST be present",
      "RULE-PROD-005: allOf MUST reference only product_entity ontology",
      "RULE-PROD-006: inventory.availableQuantity and inventory.stockStatus MUST be present"
    ]
  }
}

Filled Example Instance

https://schemas.meta-aiml.org/v3.0.0/examples/product_example_schema_v3.json

{
  "@context": [
    "https://schemas.meta-aiml.org/v3.0.0/context.jsonld"
  ],
  "@id": "https://data.meta-aiml.org/v3.0.0/examples/product/aurora-blend-pro-x1",
  "$id": "https://data.meta-aiml.org/v3.0.0/examples/product/aurora-blend-pro-x1",
  "@type": "Product",
  "schemaVersion": "3.0.0",
  "aimlVersion": "3.0.0",
  "title": "Example Filled Product Entity (Aurora Blend Pro X1)",
  "ontologicalMode": "ProductEntity",
  "domain": "Commerce",
  "businessModel": [
    "Transactional",
    "Wholesale"
  ],
  "deliveryFormat": [
    "PhysicalGoods"
  ],
  "name": {
    "en": "Aurora Blend Pro X1",
    "es": "Aurora Blend Pro X1",
    "fr": "Aurora Blend Pro X1"
  },
  "description": {
    "en": "Aurora Blend Pro X1 is a fictional countertop blender product artifact with defined inventory, fulfillment lifecycle, and compliance metadata for retail distribution.",
    "es": "Aurora Blend Pro X1 es un producto ficticio tipo licuadora con inventario definido, ciclo de cumplimiento y metadatos de conformidad para distribucion retail.",
    "fr": "Aurora Blend Pro X1 est un produit fictif de type blender avec inventaire defini, cycle logistique et metadonnees de conformite pour distribution retail."
  },
  "shortDescription": {
    "en": "Standalone physical product schema with inventory, lifecycle, and compliance metadata.",
    "es": "Esquema de producto fisico con inventario, ciclo de vida y metadatos de cumplimiento.",
    "fr": "Schema de produit physique avec inventaire, cycle de vie et metadonnees de conformite."
  },
  "url": "https://catalog.aurora-home.example/products/blend-pro-x1",
  "foundingDate": "2025-09-01",
  "createdDate": "2026-02-20T21:14:00Z",
  "lastModified": "2026-02-20T21:14:00Z",
  "productType": "physical",
  "inventory": {
    "availableQuantity": 1240,
    "stockStatus": "in_stock",
    "reorderPoint": 220,
    "warehouseLocations": [
      "US-WEST-1",
      "US-CENTRAL-1",
      "EU-WEST-1"
    ]
  },
  "examples": [
    {
      "scenario": "Holiday demand forecast increase",
      "note": "AI should prioritize inventory and fulfillment modules for reorder planning and lead-time communication."
    },
    {
      "scenario": "Regulatory compliance update for electrical certification",
      "note": "AI should route updates through compliance module fields and avoid changing unrelated product identity metadata."
    }
  ],
  "properties": {
    "productCategory": "kitchen_appliance",
    "brand": "Aurora Home",
    "sku": "AH-BPX1-2026",
    "barcode": "0123456789012",
    "warrantyMonths": 24,
    "shelfLifeDays": 3650,
    "identifiers": [
      {
        "type": "sku",
        "value": "AH-BPX1-2026"
      },
      {
        "type": "upc",
        "value": "0123456789012"
      },
      {
        "type": "url",
        "value": "https://catalog.aurora-home.example/products/blend-pro-x1"
      }
    ]
  },
  "capabilities": {
    "commerce": {
      "features": [
        "productCatalog",
        "pricing",
        "search",
        "filtering",
        "comparisons"
      ],
      "hasProductCatalog": true,
      "catalogSize": 1,
      "supportsCart": false,
      "supportsCheckout": true,
      "hasOrderTracking": true,
      "recommendationEngine": false,
      "vendorManagement": false,
      "searchCapability": true,
      "filteringOptions": [
        "color",
        "power",
        "capacity"
      ]
    },
    "financial": {
      "features": [
        "payments",
        "invoicing",
        "refunds",
        "billing"
      ],
      "paymentMethods": [
        "credit_card",
        "debit_card",
        "bank_transfer"
      ],
      "acceptsCreditCards": true,
      "currencies": [
        "USD",
        "EUR"
      ],
      "priceRange": "mid_tier",
      "commissionModel": "fixed_price",
      "commissionRate": 0,
      "supportsSubscriptions": false,
      "supportsInvoicing": true,
      "refundPolicy": "partial_refund"
    },
    "content": {
      "features": [
        "publishing",
        "search",
        "categories",
        "tags",
        "archives"
      ],
      "contentTypes": [
        "spec_sheet",
        "manual",
        "safety_notice",
        "warranty_info"
      ],
      "contentFormats": [
        "text",
        "html",
        "pdf"
      ],
      "contentAccess": [
        "public"
      ],
      "editorialControl": true,
      "userGeneratedContent": false,
      "mediaHosting": false,
      "searchPossible": true,
      "hasCategorization": true,
      "hasTagging": true,
      "archiveAccess": true,
      "rssFeeds": false
    }
  },
  "modules": {
    "lifecycle": {
      "supportsVersioning": true,
      "replacementPolicy": "replace_on_failure_within_warranty",
      "endOfLifeDate": "2031-12-31"
    },
    "fulfillment": {
      "leadTimeDays": 2,
      "returnWindowDays": 30,
      "supportsDropShipping": true
    },
    "compliance": {
      "certifications": [
        "UL",
        "CE",
        "FCC"
      ],
      "hazmatClassification": "none",
      "countryRestrictions": [
        "none"
      ]
    }
  },
  "structuralMetadata": {
    "entityNature": "product_item",
    "distributionModel": "physical_distribution",
    "versioningModel": "custom",
    "contentOwnership": "platform"
  },
  "targetAudience": [
    "home_cooks",
    "small_cafes",
    "appliance_retailers"
  ],
  "siteCapabilities": {
    "supportedDevices": [
      "desktop",
      "mobile",
      "tablet"
    ],
    "languages": [
      "en",
      "es",
      "fr"
    ],
    "accessibilityFeatures": [
      "keyboard_navigation",
      "screen_reader_labels",
      "text_scaling"
    ]
  },
  "validationMetadata": {
    "schemaVersion": "3.0.0",
    "phase": "example_instance",
    "status": "reference",
    "lastValidated": "2026-02-20T21:14:00Z",
    "validator": "META-AIML SDK v3"
  },
  "semanticAnnotations": {
    "classificationRationale": "Product is modeled as ProductEntity because the schema describes an item artifact and its inventory/lifecycle state, not an interaction platform.",
    "disambiguationNotes": "No interactionArchetype is used because product entities represent catalog objects, while service behavior belongs to platform entities.",
    "intendedUse": "Canonical example for standalone physical product schema entries."
  },
  "governanceMetadata": {
    "entityVersion": "3.0.0",
    "introducedIn": "META-AIML v3.0.0",
    "stabilityLevel": "reference",
    "sdkValidationRules": [
      "RULE-PRDX-001: @type MUST equal \"Product\"",
      "RULE-PRDX-002: ontologicalMode MUST equal \"ProductEntity\"",
      "RULE-PRDX-003: interactionArchetype MUST NOT be present",
      "RULE-PRDX-004: productType and inventory MUST be present",
      "RULE-PRDX-005: inventory.availableQuantity and inventory.stockStatus MUST be populated",
      "RULE-PRDX-006: examples MUST include at least two operational scenarios"
    ]
  }
}

All entities OnlineBanking SoftwareProduct