Product Entity

v2.0.1
Product Offering
Physical Product

A future-ready, compositional product entity schema for AI/agentic use cases. Designed for AI agents to understand product features, availability, specifications, and purchasing options.

Entity Hierarchy
Product
→
product_offering
→
physical_product
→
product

Format: @type → entityCategory → subcategory → entityType

0

Required Modules

2

Recommended Modules

12+

Functional Features

6

Site Actions

Revolutionary AI Features in v2.0.1
Perfect AI understanding with zero ambiguity

Entity Capabilities

Machine-readable product features: availability, warranty, specifications, reviews, support

Site Capabilities

Available actions for AI agents: viewing specs, reading reviews, comparing, purchasing

Required Modules
No required modules for products

Product entities have no mandatory modules, allowing maximum flexibility for different product types.

Recommended Modules
Enhance product functionality and global reach
Recommended
multilingual
Recommended
location
Entity Capabilities
Objective, verifiable product features and attributes. Define functional capabilities using camelCase naming with prefixes: "has", "is", "accepts", "supports".
Naming Convention Rules
  • • Use camelCase formatting (e.g., "hasWarranty", "isInStock")
  • • Start with prefixes: "has", "is", "accepts", "supports"
  • • Examples shown below can be extended - no limitations on additional capabilities
  • • All values are boolean (true/false) for objective verification

Product Information

hasSpecifications

Detailed technical specifications

hasImages

Product photography available

hasVideos

Product demonstration videos

hasUserManual

User manual or documentation

Availability & Support

isInStock

Product currently available

hasWarranty

Warranty coverage included

isReturnablePolicy

Return policy available

hasCustomerSupport

Customer support accessible

Social & Comparison

hasReviews

Customer reviews available

hasComparisonChart

Product comparison features

supportsCustomization

Customization options available

hasRecommendations

Related product suggestions

Site Capabilities
Available actions for AI agents and automated systems. Define what users can actually do on your website using snake_case action names.
Action Naming Rules
  • • Use snake_case formatting (e.g., "view_specifications", "add_to_cart")
  • • Actions should be verb-based describing what users can do
  • • Examples shown below are common patterns - extend with your specific actions
  • • List only actions that actually work on your website
view_specifications

Browse detailed product specs

read_reviews

View customer feedback

compare_products

Compare with similar items

check_availability

Verify stock status

add_to_cart

Add product to shopping cart

view_images

Browse product gallery

Schema Structure
Product entity schema definition
product.json
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "aimlVersion": "2.0.1",
  "schemaVersion": "2.0.1",
  "title": "Product Entity Schema",
  "description": "A future-ready, compositional product entity schema for AI/agentic use cases",
  "type": "object",
  "properties": {
    "entityType": {
      "const": "product",
      "description": "Entity type identifier"
    },
    "entityCategory": {
      "const": "product_offering",
      "description": "Entity category"
    },
    "subcategory": {
      "const": "physical_product",
      "description": "Subcategory of product offering"
    },
    "name": {
      "oneOf": [
        { "type": "string" },
        { "$ref": "../components/multilingual-format.json#/$defs/LocalizedText" }
      ],
      "description": "Product name"
    },
    "description": {
      "oneOf": [
        { "type": "string" },
        { "$ref": "../components/multilingual-format.json#/$defs/LocalizedText" }
      ],
      "description": "Detailed description of the product"
    },
    "modules": {
      "type": "object",
      "description": "AIML modules used by this entity"
    },
    "properties": {
      "type": "object",
      "description": "Product specific properties",
      "properties": {
        "category": {
          "type": "string",
          "description": "Product category"
        },
        "brand": {
          "type": "string",
          "description": "Product brand name"
        }
      }
    },
    "entityCapabilities": {
      "$ref": "../components/entity-capabilities-format.json#/$defs/EntityCapabilities",
      "description": "Objective capabilities and features of the entity"
    },
    "siteCapabilities": {
      "$ref": "../components/site-capabilities-format.json#/$defs/SiteCapabilities",
      "description": "Website capabilities and interaction features"
    }
  },
  "required": ["entityType", "entityCategory", "subcategory", "name", "description", "properties"],
  "allOf": [{ "$ref": "../base/product_offering.json" }]
}
Complete Implementation Example
Real-world product entity with all v2.0.1 features
WirelessPro 3000 Headphones - Complete Schema
{
  "@context": "https://schemas.meta-aiml.org/v2.0.1/context.jsonld",
  "@id": "https://techstore.com/products/wireless-headphones-pro/entity",
  "@type": "Product",
  "schemaVersion": "2.0.1",
  "entityType": "product",
  "entityCategory": "product_offering",
  "subcategory": "physical_product",

  "name": {
    "en": "WirelessPro 3000 Headphones",
    "es": "Auriculares WirelessPro 3000"
  },
  "description": {
    "en": "Premium wireless over-ear headphones with active noise cancellation, 30-hour battery life, and studio-quality sound for professional and personal use."
  },
  "url": "https://techstore.com/products/wireless-headphones-pro",
  "foundingDate": "2023-05-15",

  "properties": {
    "category": "electronics",
    "brand": "TechPro",
    "model": "WirelessPro 3000",
    "price": "$299.99",
    "availability": "in_stock",
    "warranty": "2_years",
    "dimensions": "18cm x 20cm x 8cm",
    "weight": "280g"
  },

  "modules": {
    "multilingual": {
      "version": "2.0.1",
      "enabled": true,
      "supported_languages": ["en", "es", "fr"],
      "auto_translation": false
    },
    "location": {
      "version": "2.0.1",
      "enabled": true,
      "shipping_regions": ["North America", "Europe", "Asia"],
      "local_warehouses": true
    }
  },

  "entityCapabilities": {
    "functionalFeatures": {
      "hasWarranty": true,
      "isInStock": true,
      "hasReviews": true,
      "hasSpecifications": true,
      "hasImages": true,
      "hasVideos": true,
      "supportsCustomization": false,
      "hasUserManual": true,
      "isReturnablePolicy": true,
      "hasComparisonChart": true
    },
    "contentTypes": ["specifications", "images", "videos", "reviews", "manual"],
    "businessModel": "physical_product",
    "productType": "electronics",
    "targetAudience": ["professionals", "audiophiles", "general_consumers"],
    "qualityAssurance": ["warranty", "return_policy", "quality_testing"]
  },

  "siteCapabilities": {
    "availableActions": [
      "view_specifications", "read_reviews", "compare_products",
      "check_availability", "add_to_cart", "view_images"
    ],
    "interactionMethods": ["online_purchase", "customer_support", "live_chat"],
    "contentAccess": ["public"],
    "supportedDevices": ["desktop", "mobile", "tablet"],
    "languages": ["en", "es", "fr"],
    "realTimeFeatures": ["stock_status", "price_updates", "availability_alerts"]
  }
}
Related Entities
EcommerceStore
Online store selling products
Marketplace
Multi-vendor platform
SoftwareProduct
Digital software offerings
Schema URL
Direct access to the product entity schema
https://schemas.meta-aiml.org/v2.0.1/entity/product.json

Inherits from product_offering base schema via allOf reference

← All EntitiesProduct Offering Base →Multilingual Module →Try in Playground →