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.Store
v3.0.0
PhysicalEntity
Retail
v3 schema for physical retail stores as static website intelligence profile: durable store metadata plus external source links for dynamic catalog/review data.
Top-level required
10
Required modules
1
Capability groups
1
Entity properties
6
Canonical Files
Inheritance Chain
https://schemas.meta-aiml.org/v3.0.0/ontology/physical_entity.json
https://schemas.meta-aiml.org/v3.0.0/archetypes/direct_service.json
Interaction archetype
DirectService
Required Top-level Fields
These fields are enforced by JSON Schema required[] at root level.
@type
ontologicalMode
interactionArchetype
domain
name
description
deliveryFormat
modules
capabilities
structuralMetadata
Non-universal required fields
interactionArchetype
Entity-specific Properties
Keys under
properties.properties dedicated to this entity contract.assortmentBreadth
averageFootfallPerDay
storeFormat
supportsCurbsidePickup
supportsInStorePickup
supportsReturnsAtStore
Modules Contract
Required modules
location
Optional modules
checkout
inventory
reviews
Capabilities Contract
Required capability groups
interaction
Optional capability groups
amenities
commerce
financial
location
Governance Validation Rules
Normative rule list from
governanceMetadata.sdkValidationRules.RULE-STOR-001: @type MUST equal "Store"
RULE-STOR-002: ontologicalMode MUST equal "PhysicalEntity"
RULE-STOR-003: interactionArchetype MUST contain "DirectService"
RULE-STOR-004: deliveryFormat MUST contain "PhysicalLocation"
RULE-STOR-005: modules.location MUST be present
RULE-STOR-006: capabilities.interaction MUST be present
RULE-STOR-007: modules.inventory.inventoryDiscovery.dataSources MUST include sourceType/sourceUrl/format
RULE-STOR-008: modules.reviews.ratingSources MUST include provider/sourceUrl when review sources are declared
Canonical Contract JSON
https://schemas.meta-aiml.org/v3.0.0/entity/store.json
https://schemas.meta-aiml.org/v3.0.0/entity/store.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/store.json",
"$id": "https://schemas.meta-aiml.org/v3.0.0/entity/store.json",
"@type": "Store",
"schemaVersion": "3.0.0",
"aimlVersion": "3.0.0",
"title": "Store Entity Schema",
"description": "v3 schema for physical retail stores as static website intelligence profile: durable store metadata plus external source links for dynamic catalog/review data.",
"examples": [
{
"description": "Neighborhood grocery store with in-store checkout and curbside pickup",
"reference": "store_example_grocery"
},
{
"description": "Specialty retail store with membership discounts and digital catalog lookup",
"reference": "store_example_specialty_retail"
}
],
"type": "object",
"additionalProperties": false,
"allOf": [
{
"$ref": "../ontology/physical_entity.json"
},
{
"$ref": "../archetypes/direct_service.json"
}
],
"properties": {
"@type": {
"const": "Store"
},
"ontologicalMode": {
"const": "PhysicalEntity"
},
"interactionArchetype": {
"type": "array",
"contains": {
"const": "DirectService"
},
"items": {
"type": "string",
"enum": [
"DirectService"
]
}
},
"domain": {
"const": "Retail"
},
"businessModel": {
"type": "array",
"items": {
"type": "string",
"enum": [
"Transactional",
"Membership",
"Subscription"
]
}
},
"deliveryFormat": {
"type": "array",
"items": {
"type": "string",
"enum": [
"PhysicalLocation",
"WebApp",
"MobileApp"
]
},
"contains": {
"const": "PhysicalLocation"
}
},
"name": {
"$ref": "../components/multilingual_format.json#/$defs/LocalizedText"
},
"description": {
"$ref": "../components/multilingual_format.json#/$defs/LocalizedText"
},
"shortDescription": {
"$ref": "../components/multilingual_format.json#/$defs/LocalizedTextOrString"
},
"url": {
"type": "string",
"format": "uri"
},
"foundingDate": {
"type": "string",
"format": "date"
},
"properties": {
"type": "object",
"properties": {
"storeFormat": {
"type": "string",
"enum": [
"grocery",
"department",
"specialty",
"convenience",
"showroom"
]
},
"assortmentBreadth": {
"type": "string",
"enum": [
"narrow",
"moderate",
"broad"
]
},
"supportsInStorePickup": {
"type": "boolean"
},
"supportsCurbsidePickup": {
"type": "boolean"
},
"supportsReturnsAtStore": {
"type": "boolean"
},
"averageFootfallPerDay": {
"type": "integer",
"minimum": 0
}
}
},
"capabilities": {
"type": "object",
"required": [
"interaction"
],
"properties": {
"commerce": {
"$ref": "../components/capability_groups.json#/$defs/CommerceCapabilities"
},
"financial": {
"$ref": "../components/capability_groups.json#/$defs/FinancialCapabilities"
},
"interaction": {
"$ref": "../components/capability_groups.json#/$defs/InteractionCapabilities"
},
"location": {
"$ref": "../components/capability_groups.json#/$defs/LocationCapabilities"
},
"amenities": {
"$ref": "../components/capability_groups.json#/$defs/AmenitiesCapabilities"
}
}
},
"modules": {
"type": "object",
"required": [
"location"
],
"properties": {
"location": {
"type": "object",
"properties": {
"address": {
"$ref": "../components/address_format.json#/$defs/PostalAddress"
},
"geoCoordinates": {
"$ref": "../components/address_format.json#/$defs/GeoCoordinates"
},
"floorMapAvailable": {
"type": "boolean"
}
}
},
"inventory": {
"type": "object",
"properties": {
"skuCount": {
"type": "integer",
"minimum": 0
},
"restockCadence": {
"type": "string",
"enum": [
"daily",
"weekly",
"mixed"
]
},
"supportsRealtimeStockVisibility": {
"type": "boolean"
},
"inventoryDiscovery": {
"type": "object",
"required": [
"dataSources"
],
"properties": {
"canonicalCatalogUrl": {
"type": "string",
"format": "uri"
},
"dataSources": {
"type": "array",
"minItems": 1,
"items": {
"type": "object",
"required": [
"sourceType",
"sourceUrl",
"format"
],
"properties": {
"sourceType": {
"type": "string",
"enum": [
"file_export",
"public_feed_page",
"public_api_endpoint",
"other"
]
},
"sourceUrl": {
"type": "string",
"format": "uri"
},
"format": {
"type": "string",
"enum": [
"json",
"xml",
"csv",
"rss",
"html",
"other"
]
},
"updateCadence": {
"type": "string",
"enum": [
"real_time",
"hourly",
"daily",
"weekly",
"manual"
]
}
}
}
}
}
}
}
},
"checkout": {
"type": "object",
"properties": {
"selfCheckoutEnabled": {
"type": "boolean"
},
"posIntegratedLoyalty": {
"type": "boolean"
},
"digitalReceiptEnabled": {
"type": "boolean"
}
}
},
"reviews": {
"type": "object",
"properties": {
"ratingSources": {
"type": "array",
"minItems": 1,
"items": {
"type": "object",
"required": [
"provider",
"sourceUrl"
],
"properties": {
"provider": {
"type": "string",
"enum": [
"google_business_profile",
"yelp",
"tripadvisor",
"opentable",
"facebook",
"custom"
]
},
"sourceType": {
"type": "string",
"enum": [
"public_page",
"official_export",
"public_api_endpoint",
"other"
]
},
"sourceUrl": {
"type": "string",
"format": "uri"
},
"format": {
"type": "string",
"enum": [
"json",
"xml",
"csv",
"rss",
"html",
"other"
]
},
"updateCadence": {
"type": "string",
"enum": [
"real_time",
"hourly",
"daily",
"weekly",
"manual"
]
}
}
}
},
"retrievalPolicy": {
"type": "object",
"properties": {
"requiresLiveFetch": {
"type": "boolean"
},
"recommendedRefreshHours": {
"type": "integer",
"minimum": 1
}
}
}
}
}
}
},
"structuralMetadata": {
"type": "object",
"properties": {
"topology": {
"const": "binary"
},
"roles": {
"const": [
"user",
"platform"
]
},
"valueSource": {
"const": "platform_provided"
},
"transactionFlow": {
"const": "direct"
},
"networkEffects": {
"const": "none"
},
"serviceMode": {
"type": "string",
"enum": [
"in_person",
"omnichannel",
"hybrid"
]
}
}
},
"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",
"interactionArchetype",
"domain",
"name",
"description",
"deliveryFormat",
"modules",
"capabilities",
"structuralMetadata"
],
"validationMetadata": {
"schemaVersion": "3.0.0",
"phase": "entity",
"status": "draft",
"lastValidated": "2026-02-20T12:00:00Z",
"validator": "META-AIML QA"
},
"semanticAnnotations": {
"classificationRationale": "Store is modeled as PhysicalEntity because core value delivery depends on physical premises and local inventory availability. DirectService applies because the store transacts directly with customers.",
"disambiguationNotes": "Different from ecommerce_store (digital direct sales) and marketplace (third-party mediation). For static website deployment, avoid embedding full product/review snapshots; use source links in modules.inventory.inventoryDiscovery and modules.reviews.ratingSources."
},
"governanceMetadata": {
"entityVersion": "3.0.0",
"introducedIn": "META-AIML v3.0.0",
"stabilityLevel": "draft",
"sdkValidationRules": [
"RULE-STOR-001: @type MUST equal \"Store\"",
"RULE-STOR-002: ontologicalMode MUST equal \"PhysicalEntity\"",
"RULE-STOR-003: interactionArchetype MUST contain \"DirectService\"",
"RULE-STOR-004: deliveryFormat MUST contain \"PhysicalLocation\"",
"RULE-STOR-005: modules.location MUST be present",
"RULE-STOR-006: capabilities.interaction MUST be present",
"RULE-STOR-007: modules.inventory.inventoryDiscovery.dataSources MUST include sourceType/sourceUrl/format",
"RULE-STOR-008: modules.reviews.ratingSources MUST include provider/sourceUrl when review sources are declared"
]
}
}Filled Example Instance
https://schemas.meta-aiml.org/v3.0.0/examples/store_example_schema_v3.json
https://schemas.meta-aiml.org/v3.0.0/examples/store_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/store/lumen-mart-napa",
"$id": "https://data.meta-aiml.org/v3.0.0/examples/store/lumen-mart-napa",
"@type": "Store",
"schemaVersion": "3.0.0",
"aimlVersion": "3.0.0",
"title": "Example Filled Store Entity Example (Lumen Mart Napa)",
"ontologicalMode": "PhysicalEntity",
"interactionArchetype": [
"DirectService"
],
"domain": "Retail",
"businessModel": [
"Transactional",
"Membership"
],
"deliveryFormat": [
"PhysicalLocation",
"WebApp",
"MobileApp"
],
"name": {
"en": "Lumen Mart Napa",
"es": "Lumen Mart Napa",
"fr": "Lumen Mart Napa"
},
"description": {
"en": "Lumen Mart Napa is a fictional neighborhood retail store with physical checkout, pickup support, and AI-discoverable catalog links for real-time product availability.",
"es": "Lumen Mart Napa es una tienda minorista ficticia de barrio con caja fisica, soporte de recogida y enlaces de catalogo para que la IA consulte disponibilidad actual.",
"fr": "Lumen Mart Napa est un magasin de detail fictif avec caisse physique, retrait en magasin et liens de catalogue pour recuperer la disponibilite en temps reel."
},
"shortDescription": {
"en": "Neighborhood physical store with source-link catalog discovery.",
"es": "Tienda fisica de barrio con descubrimiento de catalogo por enlaces.",
"fr": "Magasin physique de proximite avec decouverte de catalogue par liens."
},
"url": "https://lumenmart-napa.example",
"foundingDate": "2017-09-12",
"createdDate": "2026-02-20T18:00:00Z",
"lastModified": "2026-02-20T18:00:00Z",
"examples": [
{
"scenario": "Weekend stock updates",
"note": "Agent reads inventory links and fetches fresh stock metadata before generating answers."
},
{
"scenario": "Holiday promotion week",
"note": "Static schema stays unchanged while downstream feeds provide temporary assortment and pricing updates."
}
],
"properties": {
"storeFormat": "grocery",
"assortmentBreadth": "broad",
"supportsInStorePickup": true,
"supportsCurbsidePickup": true,
"supportsReturnsAtStore": true,
"averageFootfallPerDay": 820,
"identifiers": [
{
"type": "url",
"value": "https://lumenmart-napa.example"
},
{
"type": "custom",
"value": "STORE-NAPA-001"
}
]
},
"capabilities": {
"interaction": {
"features": [
"messaging",
"notifications",
"reviews"
],
"interactionMethods": [
"online_form",
"phone_call",
"in_person"
],
"availableActions": [
"find_product",
"check_pickup",
"contact_store"
],
"hasMessaging": true,
"hasComments": false,
"hasRating": true,
"hasReviews": true,
"hasSocialGraph": false,
"hasFeed": false,
"hasNotifications": true,
"hasMatching": false,
"realTimeCommunication": false,
"moderationEnabled": true,
"privacyControls": [
"public",
"private"
]
},
"commerce": {
"features": [
"productCatalog",
"checkout",
"inventory",
"search",
"filtering"
],
"hasProductCatalog": true,
"catalogSize": 12000,
"supportsCart": false,
"supportsCheckout": true,
"hasOrderTracking": false,
"recommendationEngine": true,
"vendorManagement": false,
"searchCapability": true,
"filteringOptions": [
"category",
"brand",
"availability"
]
},
"financial": {
"features": [
"payments",
"refunds",
"billing"
],
"paymentMethods": [
"credit_card",
"debit_card",
"digital_wallet",
"cash"
],
"acceptsCreditCards": true,
"currencies": [
"USD"
],
"priceRange": "$$",
"commissionModel": "fixed_price",
"commissionRate": 0,
"supportsSubscriptions": false,
"supportsInvoicing": true,
"refundPolicy": "full_refund"
},
"location": {
"features": [
"physicalAddress",
"geoCoordinates",
"directions",
"mapIntegration"
],
"hasPhysicalAddress": true,
"hasGeoCoordinates": true,
"hasMultipleLocations": false,
"hasParking": true,
"parkingType": "free",
"isWheelchairAccessible": true,
"publicTransitAccess": true,
"deliveryZones": [],
"serviceRadius": 0
},
"amenities": {
"features": [
"wifi",
"parking",
"accessibility",
"childFriendly"
],
"hasWifi": true,
"wifiSpeed": "standard",
"hasPowerOutlets": false,
"hasOutdoorSeating": false,
"hasVegetarianOptions": false,
"hasVeganOptions": false,
"hasGlutenFreeOptions": false,
"petPolicy": "not_allowed",
"isChildFriendly": true,
"hasPlayArea": false,
"hasHighchairs": false,
"hasChangingFacilities": true,
"isQuiet": false,
"hasPrivateRooms": false
}
},
"modules": {
"location": {
"address": {
"streetAddress": "412 Main Street",
"addressLocality": "Napa",
"addressRegion": "CA",
"postalCode": "94559",
"addressCountry": "US"
},
"geoCoordinates": {
"latitude": 38.2972,
"longitude": -122.2855,
"accuracy": 5
},
"floorMapAvailable": true
},
"inventory": {
"skuCount": 12000,
"restockCadence": "daily",
"supportsRealtimeStockVisibility": true,
"inventoryDiscovery": {
"canonicalCatalogUrl": "https://lumenmart-napa.example/catalog",
"dataSources": [
{
"sourceType": "file_export",
"sourceUrl": "https://lumenmart-napa.example/data/inventory-feed.xml",
"format": "xml",
"updateCadence": "daily"
}
]
}
},
"checkout": {
"selfCheckoutEnabled": true,
"posIntegratedLoyalty": true,
"digitalReceiptEnabled": true
},
"reviews": {
"ratingSources": [
{
"provider": "google_business_profile",
"sourceType": "public_page",
"sourceUrl": "https://www.google.com/maps/place/Lumen+Mart+Napa",
"format": "html",
"updateCadence": "daily"
},
{
"provider": "yelp",
"sourceType": "public_page",
"sourceUrl": "https://www.yelp.com/biz/lumen-mart-napa",
"format": "html",
"updateCadence": "weekly"
}
],
"retrievalPolicy": {
"requiresLiveFetch": true,
"recommendedRefreshHours": 24
}
}
},
"structuralMetadata": {
"topology": "binary",
"roles": [
"user",
"platform"
],
"valueSource": "platform_provided",
"transactionFlow": "direct",
"networkEffects": "none",
"serviceMode": "omnichannel"
},
"targetAudience": [
"families",
"local_community",
"daily_shoppers"
],
"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-20T18:00:00Z",
"validator": "META-AIML SDK v3"
},
"semanticAnnotations": {
"classificationRationale": "Store maps to PhysicalEntity plus DirectService because value delivery requires in-person operations and direct first-party transaction flow.",
"disambiguationNotes": "This is not a pure digital storefront or marketplace. Dynamic inventory and ratings are represented through source links for runtime fetching.",
"intendedUse": "Canonical filled reference for static website schema with source-link product and review discovery."
},
"governanceMetadata": {
"entityVersion": "3.0.0",
"introducedIn": "META-AIML v3.0.0",
"stabilityLevel": "reference",
"sdkValidationRules": [
"RULE-STORG-001: @type MUST equal \"Store\"",
"RULE-STORG-002: ontologicalMode MUST equal \"PhysicalEntity\"",
"RULE-STORG-003: interactionArchetype MUST contain exactly one value: \"DirectService\"",
"RULE-STORG-004: modules.location MUST include valid address and geoCoordinates",
"RULE-STORG-005: modules.inventory.inventoryDiscovery MUST declare external source links and avoid embedded product snapshots",
"RULE-STORG-006: modules.reviews MUST declare source links and avoid embedded fixed rating snapshots",
"RULE-STORG-007: examples MUST include at least two practical scenarios",
"RULE-STORG-008: validationMetadata and governanceMetadata MUST be present and version-aligned"
]
}
}