Ecommerce Store Entity
Comprehensive schema for e-commerce stores and online retail platforms. Designed for AI agents to understand product offerings, shopping capabilities, and customer experience features.
Format: @type → entityCategory → subcategory → entityType
Required Modules
Recommended Modules
Functional Features
Site Actions
Entity Capabilities
Machine-readable store features: payments, cart, search, reviews, inventory tracking
Site Capabilities
Available actions for AI agents: browsing, purchasing, reviewing, order tracking
REQUIRED - User authentication and account management
Essential for user accounts, order history, and personalized shopping
REQUIRED - Payment processing and financial transactions
Core functionality for online commerce transactions
Naming Convention Rules
- • Use camelCase formatting (e.g., "hasOnlinePayments", "hasShoppingCart")
- • 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
Core E-commerce Features
hasOnlinePaymentsProcess online payments securely
hasShoppingCartShopping cart functionality
hasProductSearchSearch products by various criteria
hasInventoryTrackingReal-time inventory management
Customer Experience
hasWishlistSave products for later purchase
hasProductReviewsCustomer product reviews and ratings
hasProductComparisonCompare multiple products
hasLoyaltyProgramCustomer loyalty and rewards program
Order Management
hasOrderTrackingTrack order status and shipping
hasReturnPolicyReturns and refunds processing
hasCheckoutAsGuestGuest checkout without account
hasGiftCardsGift card purchase and redemption
Advanced Features
hasProductFiltersAdvanced product filtering options
hasMultipleCurrenciesSupport for multiple currencies
hasSubscriptionProductsRecurring product subscriptions
hasDigitalProductsDigital product delivery
Action Naming Rules
- • Use snake_case formatting (e.g., "browse_products", "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 store
browse_productsBrowse and discover products in store
add_to_cartAdd products to shopping cart
checkoutComplete purchase and payment
track_orderMonitor order status and shipping
write_reviewSubmit product reviews and ratings
create_wishlistSave products to wishlist
compare_productsCompare product features and prices
apply_couponApply discount codes and promotions
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"aimlVersion": "2.0.1",
"schemaVersion": "2.0.1",
"title": "E-commerce Store Schema",
"description": "Schema for an e-commerce store selling products online",
"type": "object",
"properties": {
"entityType": {
"const": "ecommerce_store",
"description": "Entity type identifier"
},
"entityCategory": {
"const": "product_offering",
"description": "Entity category"
},
"subcategory": {
"const": "ecommerce_platform",
"description": "Subcategory of product offering"
},
"name": {
"oneOf": [
{ "type": "string" },
{ "$ref": "../components/multilingual-format.json#/$defs/LocalizedText" }
],
"description": "E-commerce store name"
},
"description": {
"oneOf": [
{ "type": "string" },
{ "$ref": "../components/multilingual-format.json#/$defs/LocalizedText" }
],
"description": "Detailed description of the e-commerce store"
},
"modules": {
"type": "object",
"description": "AIML modules used by this entity"
},
"properties": {
"type": "object",
"description": "E-commerce store specific properties",
"properties": {
"businessModel": {
"type": "string",
"enum": ["retail", "wholesale", "dropshipping", "marketplace", "subscription", "hybrid"]
},
"mainCategories": {
"type": "array",
"description": "Main product categories featured on the store",
"items": { "type": "string" }
},
"brandType": {
"type": "string",
"enum": ["single-brand", "multi-brand", "private-label", "mixed"]
}
}
},
"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" }]
}{
"@context": "https://schemas.meta-aiml.org/v2.0.1/context.jsonld",
"@id": "https://shopelite.com/entity",
"@type": "EcommerceStore",
"schemaVersion": "2.0.1",
"entityType": "ecommerce_store",
"entityCategory": "product_offering",
"subcategory": "ecommerce_platform",
"name": {
"en": "ShopElite Online Store",
"es": "Tienda Online ShopElite"
},
"description": {
"en": "Premium e-commerce destination offering curated fashion, electronics, and lifestyle products with exceptional customer service and fast shipping."
},
"url": "https://shopelite.com",
"foundingDate": "2019-03-10",
"properties": {
"businessModel": "retail",
"mainCategories": ["fashion", "electronics", "home", "beauty"],
"brandType": "multi-brand",
"unique_selling_proposition": "Curated premium products with 24/7 customer support",
"target_audience": [
{
"segment": "premium_shoppers",
"demographics": {
"ageRange": "25-45",
"incomeLevel": "high",
"location": "urban"
},
"interests": ["fashion", "technology", "lifestyle"]
}
],
"fulfillmentMethods": [
{
"type": "in-house",
"description": "Same-day processing from our fulfillment center",
"typicalProcessingTime": "24 hours"
}
],
"siteFeatures": [
"advanced_search", "product_reviews", "wishlists",
"recommendations", "live_chat", "size_guides"
]
},
"modules": {
"auth": {
"version": "2.0.1",
"enabled": true,
"methods": ["email", "social"],
"providers": ["local", "google", "facebook"]
},
"payments": {
"version": "2.0.1",
"enabled": true,
"providers": ["stripe", "paypal", "apple_pay", "google_pay"],
"currencies": ["USD", "EUR", "GBP"]
},
"search": {
"version": "2.0.1",
"enabled": true,
"features": ["semantic_search", "faceted_search", "autocomplete"]
}
},
"entityCapabilities": {
"functionalFeatures": {
"hasOnlinePayments": true,
"hasShoppingCart": true,
"hasWishlist": true,
"hasProductReviews": true,
"hasInventoryTracking": true,
"hasOrderTracking": true,
"hasReturnPolicy": true,
"hasLoyaltyProgram": true,
"hasGiftCards": true,
"hasProductSearch": true,
"hasProductFilters": true,
"hasProductComparison": true,
"hasCheckoutAsGuest": true,
"hasMultipleCurrencies": false
},
"contentTypes": ["products", "reviews", "guides", "blog"],
"businessModel": "ecommerce_retail",
"productCategories": ["fashion", "electronics", "home", "beauty"],
"paymentMethods": ["credit_card", "paypal", "digital_wallet"],
"shippingOptions": ["standard", "express", "overnight", "international"]
},
"siteCapabilities": {
"availableActions": [
"browse_products", "add_to_cart", "checkout", "track_order",
"write_review", "create_wishlist", "compare_products", "apply_coupon"
],
"interactionMethods": ["online_form", "live_chat", "email"],
"contentAccess": ["public", "members_only"],
"supportedDevices": ["desktop", "mobile", "tablet"],
"languages": ["en", "es"],
"realTimeFeatures": ["live_inventory", "price_updates", "order_status"]
}
}More Efficient
vs HTML parsing
Accuracy
No guesswork
Processing Time
Instant understanding
https://schemas.meta-aiml.org/v2.0.1/entity/ecommerce_store.jsonInherits from product_offering base schema via allOf reference