Store Entity

v2.0.1
Organization
Ecommerce Platform

Schema for physical or digital stores selling products or services. Designed for AI agents to understand store capabilities, product offerings, and customer service features.

Entity Hierarchy
Store
→
organization
→
ecommerce_platform
→
store

Format: @type → entityCategory → subcategory → entityType

0

Required Modules

4

Recommended Modules

12+

Functional Features

6

Site Actions

⭐ New Features in v2.0.1

entityCapabilities

Objective store capabilities with clear rules:

  • • camelCase (hasOnlineStore, acceptsReturns)
  • • Prefixes: has, is, accepts, supports
  • • Boolean values for objective verification
  • • Examples are expandable - no limits

siteCapabilities

Actions available on store website with rules:

  • • snake_case (browse_products, place_order)
  • • Based on verbs (what users can do)
  • • Only actually working actions
  • • Examples are expandable without limits
Recommended Modules
Enhance store functionality and user experience
Recommended
auth
Recommended
payments
Recommended
location
Recommended
multilingual
Entity Capabilities
Objective, verifiable store features and services. Define functional capabilities using camelCase naming with prefixes: "has", "is", "accepts", "supports".
Naming Convention Rules
  • • Use camelCase formatting (e.g., "hasOnlineStore", "acceptsReturns")
  • • 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

Store Operations

hasOnlineStore

Online shopping platform available

hasPhysicalLocation

Physical store location exists

hasClickAndCollect

Order online, pickup in-store

hasInventoryTracking

Real-time stock management

Customer Services

acceptsReturns

Return policy in place

hasCustomerSupport

Customer service available

hasLoyaltyProgram

Customer rewards program

hasGiftCards

Gift card services

Technical Services

hasWarrantyService

Product warranty support

hasInstallationService

Product installation offered

hasTechnicalSupport

Technical assistance available

hasRepairService

Product repair services

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., "browse_products", "place_order")
  • • 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
browse_products

View product catalog and details

check_availability

Check product stock status

place_order

Purchase products online

track_order

Monitor order status and delivery

book_appointment

Schedule service appointments

contact_support

Get customer assistance

Schema Structure
Store entity schema definition
store.json
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "aimlVersion": "2.0.1",
  "schemaVersion": "2.0.1",
  "title": "Store Entity Schema",
  "description": "Schema for a physical or digital store selling products or services",
  "type": "object",
  "properties": {
    "entityType": {
      "const": "store",
      "description": "Entity type identifier"
    },
    "entityCategory": {
      "const": "organization",
      "description": "Entity category"
    },
    "subcategory": {
      "const": "ecommerce_platform",
      "description": "Subcategory of organization"
    },
    "name": {
      "oneOf": [
        { "type": "string" },
        { "$ref": "../components/multilingual-format.json#/$defs/LocalizedText" }
      ],
      "description": "Store name"
    },
    "description": {
      "oneOf": [
        { "type": "string" },
        { "$ref": "../components/multilingual-format.json#/$defs/LocalizedText" }
      ],
      "description": "Detailed description of the store"
    },
    "modules": {
      "type": "object",
      "description": "AIML modules used by this entity"
    },
    "properties": {
      "type": "object",
      "description": "Store specific properties",
      "properties": {
        "storeType": {
          "type": "string",
          "description": "Type of store (physical, online, hybrid)"
        },
        "productCategories": {
          "type": "array",
          "items": { "type": "string" },
          "description": "Main product categories sold"
        }
      }
    },
    "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/organization.json" }]
}
Complete Implementation Example
Real-world store entity with all v2.0.1 features
TechStore Plus - Complete Schema
{
  "@context": "https://schemas.meta-aiml.org/v2.0.1/context.jsonld",
  "@id": "https://techstore.com/entity",
  "@type": "Store",
  "schemaVersion": "2.0.1",
  "entityType": "store",
  "entityCategory": "organization",
  "subcategory": "ecommerce_platform",

  "name": {
    "en": "TechStore Plus",
    "es": "TechStore Plus"
  },
  "description": {
    "en": "Leading electronics and technology store offering cutting-edge devices, accessories, and expert technical support for all your digital needs."
  },
  "url": "https://techstore.com",
  "foundingDate": "2015-08-20",

  "properties": {
    "storeType": "hybrid",
    "productCategories": ["electronics", "computers", "mobile_devices", "accessories"],
    "priceRange": "$$",
    "businessHours": "Mon-Sat 9:00-21:00, Sun 10:00-18:00"
  },

  "modules": {
    "location": {
      "version": "2.0.1",
      "enabled": true,
      "address": {
        "streetAddress": "456 Tech Avenue",
        "addressLocality": "Silicon Valley",
        "addressRegion": "CA",
        "postalCode": "94105",
        "addressCountry": "US"
      }
    },
    "payments": {
      "version": "2.0.1",
      "enabled": true,
      "providers": ["stripe", "paypal", "apple_pay"],
      "currencies": ["USD", "EUR"]
    }
  },

  "entityCapabilities": {
    "functionalFeatures": {
      "hasOnlineStore": true,
      "hasPhysicalLocation": true,
      "acceptsReturns": true,
      "hasCustomerSupport": true,
      "hasWarrantyService": true,
      "hasInstallationService": true,
      "acceptsCreditCards": true,
      "hasLoyaltyProgram": true,
      "hasClickAndCollect": true,
      "hasTechnicalSupport": true
    },
    "contentTypes": ["products", "reviews", "specifications", "support", "location"],
    "businessModel": "retail_store",
    "productCategories": ["electronics", "technology", "accessories"],
    "serviceTypes": ["retail_sales", "technical_support", "installation"],
    "targetAudience": ["tech_enthusiasts", "businesses", "general_consumers"],
    "paymentMethods": ["credit_card", "cash", "digital_wallet", "financing"]
  },

  "siteCapabilities": {
    "availableActions": [
      "browse_products", "check_availability", "place_order",
      "track_order", "book_appointment", "contact_support"
    ],
    "interactionMethods": ["online_form", "phone_call", "live_chat", "in_store_visit"],
    "contentAccess": ["public"],
    "supportedDevices": ["desktop", "mobile", "tablet"],
    "languages": ["en", "es"],
    "realTimeFeatures": ["live_inventory", "instant_chat", "real_time_support"]
  }
}
Related Entities

Same Category (Organization)

RestaurantHotelClinic

Same Subcategory (Ecommerce Platform)

EcommerceStoreMarketplace
← All EntitiesOrganization Base →Try in Playground →