Hotel Entity

v2.0.1
Organization
Hospitality

Comprehensive schema for hotels and accommodation services. Designed for AI agents to understand booking capabilities, amenities, and guest service features.

Hotel
→
organization
→
hospitality
→
hotel

Format: @type → entityCategory → subcategory → entityType

2

Required Modules

4

Recommended Modules

14+

Functional Features

8

Site Actions

⭐ New Features in v2.0.1
Perfect AI understanding with machine-readable hotel capabilities

entityCapabilities

Objective business capabilities with rules:

  • • camelCase (hasPool, acceptsReservations)
  • • Prefixes: has, is, accepts, supports
  • • Boolean values for objective verification
  • • Examples expandable - no limitations

siteCapabilities

Website actions available with rules:

  • • snake_case (view_rooms, make_reservation)
  • • Verb-based (what users can do)
  • • Only actually working actions
  • • Examples expandable without limitations
Required Modules
Essential modules for hotel entities
Required
location

REQUIRED - Physical address and geographic information

Essential for guest arrivals and location-based services

Required
payments

REQUIRED - Payment processing for reservations and services

Critical for booking confirmations and payment handling

Recommended Modules
Enhance hotel functionality and guest experience
Recommended
auth
Recommended
multilingual
Recommended
user-management
Recommended
notification
Entity Capabilities
Objective, verifiable hotel features and services. Define functional capabilities using camelCase naming with prefixes: "has", "is", "accepts", "supports".
Naming Convention Rules
  • • Use camelCase formatting (e.g., "hasPool", "acceptsReservations")
  • • 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

Accommodation Services

acceptsReservations

Room booking available

hasRoomService

In-room dining service

hasConciergService

Guest assistance services

hasValet

Valet parking and services

Hotel Amenities

hasPool

Swimming pool facilities

hasFitnessCenter

Gym and fitness equipment

hasSpa

Spa and wellness services

hasRestaurant

On-site dining options

Guest Services

hasBusinessCenter

Business facilities

hasWifi

Internet connectivity

hasParking

Parking facilities

has24HourFrontDesk

Round-the-clock reception

Accessibility & Policies

isWheelchairAccessible

ADA compliant facilities

acceptsPets

Pet-friendly accommodation

hasSmokingRooms

Smoking-permitted rooms

hasLaundryService

Laundry and dry cleaning

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_rooms", "make_reservation")
  • • 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_rooms

Browse available room types

check_availability

Check room availability for dates

make_reservation

Book rooms online

view_amenities

Explore hotel facilities

contact_hotel

Get in touch directly

view_location

Get directions and area info

read_reviews

View guest feedback

view_photos

Browse hotel and room images

Schema Structure
Hotel entity schema definition
hotel.json
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "aimlVersion": "2.0.1",
  "schemaVersion": "2.0.1",
  "title": "Hotel Entity Schema",
  "description": "Schema for hotels and accommodation services",
  "type": "object",
  "properties": {
    "entityType": {
      "const": "hotel",
      "description": "Entity type identifier"
    },
    "entityCategory": {
      "const": "organization",
      "description": "Entity category"
    },
    "subcategory": {
      "const": "hospitality",
      "description": "Subcategory of organization"
    },
    "name": {
      "oneOf": [
        { "type": "string" },
        { "$ref": "../components/multilingual-format.json#/$defs/LocalizedText" }
      ],
      "description": "Hotel name"
    },
    "description": {
      "oneOf": [
        { "type": "string" },
        { "$ref": "../components/multilingual-format.json#/$defs/LocalizedText" }
      ],
      "description": "Detailed description of the hotel"
    },
    "modules": {
      "type": "object",
      "description": "AIML modules used by this entity"
    },
    "properties": {
      "type": "object",
      "description": "Hotel specific properties",
      "properties": {
        "starRating": {
          "type": "number",
          "minimum": 1,
          "maximum": 5,
          "description": "Hotel star rating"
        },
        "checkInTime": {
          "type": "string",
          "description": "Check-in time"
        },
        "checkOutTime": {
          "type": "string",
          "description": "Check-out time"
        }
      }
    },
    "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 hotel entity with all v2.0.1 features
Grand Palace Hotel - Complete Schema
{
  "@context": "https://schemas.meta-aiml.org/v2.0.1/context.jsonld",
  "@id": "https://grandpalacehotel.com/entity",
  "@type": "Hotel",
  "schemaVersion": "2.0.1",
  "entityType": "hotel",
  "entityCategory": "organization",
  "subcategory": "hospitality",

  "name": {
    "en": "Grand Palace Hotel",
    "es": "Hotel Gran Palacio"
  },
  "description": {
    "en": "Luxury 5-star hotel in the heart of downtown, offering world-class amenities, fine dining, and exceptional service for business and leisure travelers."
  },
  "url": "https://grandpalacehotel.com",
  "foundingDate": "1925-08-20",

  "properties": {
    "starRating": 5,
    "checkInTime": "15:00",
    "checkOutTime": "11:00",
    "totalRooms": 350,
    "accommodationTypes": ["standard_room", "suite", "presidential_suite"]
  },

  "modules": {
    "location": {
      "version": "2.0.1",
      "enabled": true,
      "address": {
        "streetAddress": "789 Luxury Avenue",
        "addressLocality": "Downtown",
        "addressRegion": "NY",
        "postalCode": "10001",
        "addressCountry": "US"
      }
    },
    "payments": {
      "version": "2.0.1",
      "enabled": true,
      "providers": ["stripe", "paypal"],
      "currencies": ["USD", "EUR", "GBP"]
    }
  },

  "entityCapabilities": {
    "functionalFeatures": {
      "acceptsReservations": true,
      "hasRoomService": true,
      "hasConciergService": true,
      "hasValet": true,
      "hasPool": true,
      "hasFitnessCenter": true,
      "hasSpa": true,
      "hasRestaurant": true,
      "hasBusinessCenter": true,
      "hasWifi": true,
      "hasParking": true,
      "isWheelchairAccessible": true,
      "acceptsPets": false,
      "has24HourFrontDesk": true
    },
    "contentTypes": ["rooms", "amenities", "photos", "reviews", "location", "contact"],
    "businessModel": "hotel",
    "accommodationTypes": ["rooms", "suites"],
    "targetAudience": ["business_travelers", "tourists", "luxury_seekers"],
    "paymentMethods": ["credit_card", "debit_card", "digital_wallet"]
  },

  "siteCapabilities": {
    "availableActions": [
      "view_rooms", "check_availability", "make_reservation",
      "view_amenities", "contact_hotel", "view_location",
      "read_reviews", "view_photos"
    ],
    "interactionMethods": ["online_form", "phone_call", "email"],
    "contentAccess": ["public"],
    "supportedDevices": ["desktop", "mobile", "tablet"],
    "languages": ["en", "es"],
    "realTimeFeatures": ["real_time_availability", "instant_booking"]
  }
}
Related Entities
Similar entities in the hospitality category

Restaurant

Food service establishments with dining capabilities

hospitality