Category schema · Hotels

Hotel Schema

The Hotel Schema organises accommodation details, facilities, services and policies into a consistent format, using Schema.org vocabulary where applicable.

Complete JSON definition

1 Scope

The Hotel Schema describes a hotel. It covers identity, incorporation details, contact, and location, including the address and coordinates. It also covers facilities, rooms and bathrooms, internet and parking, food and drink, accessibility, family and pet policies, services and operating times, payment methods, and languages. A star classification, images, and reputation figures can be included when they are stated. A star classification is separate from guest reviews. Reputation figures come from one provider and are not combined into a single rating. A missing value stays unknown. A booking or a price is not part of this schema.

2 Attributes

Names outside this reference are unsupported or reserved.

2.1 Identity

Name	Type	Schema.org	Description
Identifier `hotel.id`	text	@id	The permanent unique identifier already assigned to the entity. JSON-LD states the same value as @id. The identifier is not calculated from the name, telephone, or address.
Title `hotel.title`	text	name	The name of the property.
Description `hotel.description`	text	description	A text description of the property.
Brand `hotel.brand`	entity_or_text	brand	The brand of the hotel, when a brand is stated. It is not copied from the hotel name. Text is used until a canonical entity exists. JSON-LD uses brand for that value.
Chain `hotel.chain`	entity_or_text	—	The hotel group this hotel belongs to, when that is stated. No value means unknown, not independent. Independent is recorded only when the data says the hotel is independent. A chain name stays text and is not given a schema.org property. A location chain is not a hotel group.
Owner `hotel.owner`	entity_or_text	owner	The person or organization that owns the hotel, when that is stated. It is not inferred from the brand or the chain. Text is used until a canonical entity exists. JSON-LD uses owner when that party is stated as a person or an organization.
Operator `hotel.operator`	entity_or_text	—	The organization that operates the hotel, when that is stated. It is not the brand and not the chain. Schema.org has no property for the operating organization of a hotel, so this stays unmapped.

2.2 Incorporation details

Name	Type	Schema.org	Description
Company name `hotel.company.name`	text	legalName	The registered company name, when the business is registered at Companies House and states that name. A missing value stays unknown. This is not the trading name. JSON-LD uses legalName.
Company number `hotel.company.number`	text	additionalProperty	The company number, when the business is registered at Companies House and states that number. A missing value stays unknown. This is not a VAT number. When a number is stated, JSON-LD uses a PropertyValue named companyNumber.
Incorporation date `hotel.company.incorporated_on`	date	foundingDate	The incorporation date, when the business is registered at Companies House and states that date. A missing date stays unknown. JSON-LD uses foundingDate for that stated date.
VAT number `hotel.company.vat`	text	vatID	The VAT number, when the business is registered for VAT and states that number. A missing value stays unknown. This is not the company number. JSON-LD uses vatID.

2.3 Contact

Name	Type	Schema.org	Description
Phone `hotel.contact.phone`	text	telephone	The telephone number of the property.
Url `hotel.contact.url`	url	url	The website address of the property.
Email `hotel.contact.email`	email	email	An email address for the business. Leave it empty when none is known.

2.4 Location and coordinates

Name	Type	Schema.org	Description
Address `hotel.location.address`	text	address	The postal address of the property.
Latitude `hotel.location.latitude`	number	latitude	The WGS84 latitude of the property.
Longitude `hotel.location.longitude`	number	longitude	The WGS84 longitude of the property. A coordinate pair is required before JSON-LD includes GeoCoordinates.
Postcode `hotel.location.postcode`	text	postalCode	The UK postcode when one postcode is present in the postal address.
Street `hotel.location.street`	text	streetAddress	The street line when the postal address separates it from the town.
Locality `hotel.location.locality`	text	addressLocality	The town or city when the postal address states it as its own part.
Region `hotel.location.region`	text	addressRegion	The county or region when the postal address states it as its own part.
Country `hotel.location.country`	text	addressCountry	The country when the address or an explicit country name states it.

2.5 Facilities and amenities

Name	Type	Schema.org	Description
Beach Access `hotel.activities.beach_access`	boolean	amenityFeature	Whether the property offers Beach Access.
Beach Front `hotel.activities.beach_front`	boolean	amenityFeature	Whether the property offers Beach Front.
Bicycle Rental `hotel.activities.bicycle_rental`	boolean	amenityFeature	Whether the property offers Bicycle Rental.
Boutique Shopping `hotel.activities.boutique_shopping`	boolean	amenityFeature	Whether the property offers Boutique Shopping.
Casino `hotel.activities.casino`	boolean	amenityFeature	Whether the property offers Casino.
Game Room `hotel.activities.game_room`	boolean	amenityFeature	Whether the property offers Game Room.
Golf `hotel.activities.golf`	boolean	amenityFeature	Whether the property offers Golf.
Horseback Riding `hotel.activities.horseback_riding`	boolean	amenityFeature	Whether the property offers Horseback Riding.
Nightclub `hotel.activities.nightclub`	boolean	amenityFeature	Whether the property offers Nightclub.
Scuba `hotel.activities.scuba`	boolean	amenityFeature	Whether the property offers Scuba.
Snorkeling `hotel.activities.snorkeling`	boolean	amenityFeature	Whether the property offers Snorkeling.
Tennis `hotel.activities.tennis`	boolean	amenityFeature	Whether the property offers Tennis.
Water Skiing `hotel.activities.water_skiing`	boolean	amenityFeature	Whether the property offers Water Skiing.
Watercraft Rental `hotel.activities.watercraft_rental`	boolean	amenityFeature	Whether the property offers Watercraft Rental.
Business Center `hotel.business_and_events.business_center`	boolean	amenityFeature	Whether the property offers Business Center.
Meeting Rooms `hotel.business_and_events.meeting_rooms`	boolean	amenityFeature	Whether the property offers Meeting Rooms.
Adult Only Pool `hotel.pools.adult_only_pool`	boolean	amenityFeature	Whether the property offers Adult Only Pool.
Hot Tub `hotel.pools.hot_tub`	boolean	amenityFeature	Whether the property offers Hot Tub.
Indoor Pool `hotel.pools.indoor_pool`	boolean	amenityFeature	Whether the property offers Indoor Pool.
Lazy River `hotel.pools.lazy_river`	boolean	amenityFeature	Whether the property offers Lazy River.
Lifeguard `hotel.pools.lifeguard`	boolean	amenityFeature	Whether the property offers Lifeguard.
Outdoor Pool `hotel.pools.outdoor_pool`	boolean	amenityFeature	Whether the property offers Outdoor Pool.
Pool `hotel.pools.pool`	boolean	amenityFeature	Whether the property offers Pool.
Wading Pool `hotel.pools.wading_pool`	boolean	amenityFeature	Whether the property offers Wading Pool.
Water Park `hotel.pools.water_park`	boolean	amenityFeature	Whether the property offers Water Park.
Waterslide `hotel.pools.waterslide`	boolean	amenityFeature	Whether the property offers Waterslide.
Wave Pool `hotel.pools.wave_pool`	boolean	amenityFeature	Whether the property offers Wave Pool.
Doctor On Call `hotel.wellness.doctor_on_call`	boolean	amenityFeature	Whether the property offers Doctor On Call.
Elliptical Machine `hotel.wellness.elliptical_machine`	boolean	amenityFeature	Whether the property offers Elliptical Machine.
Fitness Center `hotel.wellness.fitness_center`	boolean	amenityFeature	Whether the property offers Fitness Center.
Free Weights `hotel.wellness.free_weights`	boolean	amenityFeature	Whether the property offers Free Weights.
Hair Salon `hotel.wellness.hair_salon`	boolean	amenityFeature	Whether the property offers Hair Salon.
Massage `hotel.wellness.massage`	boolean	amenityFeature	Whether the property offers Massage.
Sauna `hotel.wellness.sauna`	boolean	amenityFeature	Whether the property offers Sauna.
Spa `hotel.wellness.spa`	boolean	amenityFeature	Whether the property offers Spa.
Treadmill `hotel.wellness.treadmill`	boolean	amenityFeature	Whether the property offers Treadmill.
Weight Machines `hotel.wellness.weight_machines`	boolean	amenityFeature	Whether the property offers Weight Machines.

2.6 Room and bathroom features

Name	Type	Schema.org	Description
Bathtub `hotel.bathrooms.bathtub`	boolean	amenityFeature	Whether the property offers Bathtub.
Bathtub In Some Rooms `hotel.bathrooms.bathtub_in_some_rooms`	boolean	—	Bathtub In Some Rooms applies to some rooms, not necessarily the whole property. It is omitted from the business JSON-LD so it is not stated for every room.
Private Bathroom `hotel.bathrooms.private_bathroom`	boolean	amenityFeature	Whether the property offers Private Bathroom.
Private Bathroom In Some Rooms `hotel.bathrooms.private_bathroom_in_some_rooms`	boolean	—	Private Bathroom In Some Rooms applies to some rooms, not necessarily the whole property. It is omitted from the business JSON-LD so it is not stated for every room.
Shower `hotel.bathrooms.shower`	boolean	amenityFeature	Whether the property offers Shower.
Shower In Some Rooms `hotel.bathrooms.shower_in_some_rooms`	boolean	—	Shower In Some Rooms applies to some rooms, not necessarily the whole property. It is omitted from the business JSON-LD so it is not stated for every room.
Air Conditioning `hotel.rooms.air_conditioning`	boolean	amenityFeature	Whether the property offers Air Conditioning.
Air Conditioning In Some Rooms `hotel.rooms.air_conditioning_in_some_rooms`	boolean	—	Air Conditioning In Some Rooms applies to some rooms, not necessarily the whole property. It is omitted from the business JSON-LD so it is not stated for every room.
Coffee Maker `hotel.rooms.coffee_maker`	boolean	amenityFeature	Whether the property offers Coffee Maker.
Coffee Maker In Some Rooms `hotel.rooms.coffee_maker_in_some_rooms`	boolean	—	Coffee Maker In Some Rooms applies to some rooms, not necessarily the whole property. It is omitted from the business JSON-LD so it is not stated for every room.
Kitchen `hotel.rooms.kitchen`	boolean	amenityFeature	Whether the property offers Kitchen.
Kitchen In Some Rooms `hotel.rooms.kitchen_in_some_rooms`	boolean	—	Kitchen In Some Rooms applies to some rooms, not necessarily the whole property. It is omitted from the business JSON-LD so it is not stated for every room.
Microwave `hotel.rooms.microwave`	boolean	amenityFeature	Whether the property offers Microwave.
Microwave In Some Rooms `hotel.rooms.microwave_in_some_rooms`	boolean	—	Microwave In Some Rooms applies to some rooms, not necessarily the whole property. It is omitted from the business JSON-LD so it is not stated for every room.
Minibar `hotel.rooms.minibar`	boolean	amenityFeature	Whether the property offers Minibar.
Minibar In Some Rooms `hotel.rooms.minibar_in_some_rooms`	boolean	—	Minibar In Some Rooms applies to some rooms, not necessarily the whole property. It is omitted from the business JSON-LD so it is not stated for every room.
Refrigerator `hotel.rooms.refrigerator`	boolean	amenityFeature	Whether the property offers Refrigerator.
Refrigerator In Some Rooms `hotel.rooms.refrigerator_in_some_rooms`	boolean	—	Refrigerator In Some Rooms applies to some rooms, not necessarily the whole property. It is omitted from the business JSON-LD so it is not stated for every room.

2.7 Internet and parking

Name	Type	Schema.org	Description
Public Internet Workstation `hotel.internet.public_internet_workstation`	boolean	amenityFeature	Whether the property offers Public Internet Workstation.
Wifi `hotel.internet.wifi`	boolean	amenityFeature	Whether the property offers Wifi.
Wifi In Public Areas `hotel.internet.wifi_in_public_areas`	boolean	amenityFeature	Whether the property offers Wifi In Public Areas.
Airport Shuttle `hotel.parking_and_transportation.airport_shuttle`	boolean	amenityFeature	Whether the property offers Airport Shuttle.
Car Rental Onsite `hotel.parking_and_transportation.car_rental_onsite`	boolean	amenityFeature	Whether the property offers Car Rental Onsite.
Electric Car Charging Stations `hotel.parking_and_transportation.electric_car_charging_stations`	boolean	amenityFeature	Whether the property offers Electric Car Charging Stations.
Local Shuttle `hotel.parking_and_transportation.local_shuttle`	boolean	amenityFeature	Whether the property offers Local Shuttle.
Parking `hotel.parking_and_transportation.parking`	boolean	amenityFeature	Whether the property offers Parking.
Private Car Service `hotel.parking_and_transportation.private_car_service`	boolean	amenityFeature	Whether the property offers Private Car Service.
Self Parking `hotel.parking_and_transportation.self_parking`	boolean	amenityFeature	Whether the property offers Self Parking.
Transfer `hotel.parking_and_transportation.transfer`	boolean	amenityFeature	Whether the property offers Transfer.
Valet Parking `hotel.parking_and_transportation.valet_parking`	boolean	amenityFeature	Whether the property offers Valet Parking.

2.8 Food and drink

Name	Type	Schema.org	Description
Bar `hotel.food_and_drink.bar`	boolean	amenityFeature	Whether the property offers Bar.
Breakfast `hotel.food_and_drink.breakfast`	boolean	amenityFeature	Whether the property offers Breakfast.
Breakfast Buffet `hotel.food_and_drink.breakfast_buffet`	boolean	amenityFeature	Whether the property offers Breakfast Buffet.
Buffet Dinner `hotel.food_and_drink.buffet_dinner`	boolean	amenityFeature	Whether the property offers Buffet Dinner.
Restaurant `hotel.food_and_drink.restaurant`	boolean	amenityFeature	Whether the property offers Restaurant.
Room Service `hotel.food_and_drink.room_service`	boolean	amenityFeature	Whether the property offers Room Service.
Table Service `hotel.food_and_drink.table_service`	boolean	amenityFeature	Whether the property offers Table Service.
Vending Machines `hotel.food_and_drink.vending_machines`	boolean	amenityFeature	Whether the property offers Vending Machines.

2.9 Accessibility

Name	Type	Schema.org	Description
Accessible `hotel.accessibility.accessible`	boolean	amenityFeature	Whether the property offers Accessible.
Accessible Elevator `hotel.accessibility.accessible_elevator`	boolean	amenityFeature	Whether the property offers Accessible Elevator.
Accessible Parking `hotel.accessibility.accessible_parking`	boolean	amenityFeature	Whether the property offers Accessible Parking.
Accessible Pool `hotel.accessibility.accessible_pool`	boolean	amenityFeature	Whether the property offers Accessible Pool.

2.10 Family and pet policies

Name	Type	Schema.org	Description
Activities For Kids `hotel.children.activities_for_kids`	boolean	amenityFeature	Whether the property offers Activities For Kids.
Babysitting `hotel.children.babysitting`	boolean	amenityFeature	Whether the property offers Babysitting.
Kid Friendly `hotel.children.kid_friendly`	boolean	amenityFeature	Whether the property offers Kid Friendly.
Kids Club `hotel.children.kids_club`	boolean	amenityFeature	Whether the property offers Kids Club.
Cats Allowed `hotel.pets.cats_allowed`	boolean	amenityFeature	Whether the property offers Cats Allowed.
Dogs Allowed `hotel.pets.dogs_allowed`	boolean	amenityFeature	Whether the property offers Dogs Allowed.
Pets Allowed `hotel.pets.pets_allowed`	boolean	petsAllowed	Whether pets are allowed.

2.11 Services and operating information

Name	Type	Schema.org	Description
Check In Time `hotel.check_in_time`	time	checkinTime	The local check-in time.
Check Out Time `hotel.check_out_time`	time	checkoutTime	The local check-out time.
Smoke Free Property `hotel.policies_and_payments.smoke_free_property`	boolean	smokingAllowed	Whether the property is smoke-free. A stated smoke-free property is JSON-LD smokingAllowed false. A missing value is unknown and is omitted. An explicit negative is not turned into smoking allowed.
Baggage Storage `hotel.services.baggage_storage`	boolean	amenityFeature	Whether the property offers Baggage Storage.
Concierge `hotel.services.concierge`	boolean	amenityFeature	Whether the property offers Concierge.
Convenience Store `hotel.services.convenience_store`	boolean	amenityFeature	Whether the property offers Convenience Store.
Currency Exchange `hotel.services.currency_exchange`	boolean	amenityFeature	Whether the property offers Currency Exchange.
Elevator `hotel.services.elevator`	boolean	amenityFeature	Whether the property offers Elevator.
Front Desk `hotel.services.front_desk`	boolean	amenityFeature	Whether the property offers Front Desk.
Full Service Laundry `hotel.services.full_service_laundry`	boolean	amenityFeature	Whether the property offers Full Service Laundry.
Gift Shop `hotel.services.gift_shop`	boolean	amenityFeature	Whether the property offers Gift Shop.
Housekeeping `hotel.services.housekeeping`	boolean	amenityFeature	Whether the property offers Housekeeping.
Self Service Laundry `hotel.services.self_service_laundry`	boolean	amenityFeature	Whether the property offers Self Service Laundry.
Social Hour `hotel.services.social_hour`	boolean	amenityFeature	Whether the property offers Social Hour.
Turndown Service `hotel.services.turndown_service`	boolean	amenityFeature	Whether the property offers Turndown Service.
Wake Up Calls `hotel.services.wake_up_calls`	boolean	amenityFeature	Whether the property offers Wake Up Calls.

2.12 Payment methods

Name	Type	Schema.org	Description
Cash `hotel.policies_and_payments.cash`	boolean	paymentAccepted	Whether Cash is accepted. A stated acceptance is included in paymentAccepted. A missing value is omitted and is not a refusal.
Checks `hotel.policies_and_payments.checks`	boolean	paymentAccepted	Whether Checks is accepted. A stated acceptance is included in paymentAccepted. A missing value is omitted and is not a refusal.
Credit Cards `hotel.policies_and_payments.credit_cards`	boolean	paymentAccepted	Whether Credit Cards is accepted. A stated acceptance is included in paymentAccepted. A missing value is omitted and is not a refusal.
Debit Cards `hotel.policies_and_payments.debit_cards`	boolean	paymentAccepted	Whether Debit Cards is accepted. A stated acceptance is included in paymentAccepted. A missing value is omitted and is not a refusal.
Nfc Mobile Payments `hotel.policies_and_payments.nfc_mobile_payments`	boolean	paymentAccepted	Whether Nfc Mobile Payments is accepted. A stated acceptance is included in paymentAccepted. A missing value is omitted and is not a refusal.

2.13 Languages

Name	Type	Schema.org	Description
Arabic `hotel.languages_spoken.arabic`	boolean	availableLanguage	Whether Arabic is spoken at the property. A stated language is included in availableLanguage. A missing value is omitted.
Cantonese `hotel.languages_spoken.cantonese`	boolean	availableLanguage	Whether Cantonese is spoken at the property. A stated language is included in availableLanguage. A missing value is omitted.
Dutch `hotel.languages_spoken.dutch`	boolean	availableLanguage	Whether Dutch is spoken at the property. A stated language is included in availableLanguage. A missing value is omitted.
English `hotel.languages_spoken.english`	boolean	availableLanguage	Whether English is spoken at the property. A stated language is included in availableLanguage. A missing value is omitted.
Filipino `hotel.languages_spoken.filipino`	boolean	availableLanguage	Whether Filipino is spoken at the property. A stated language is included in availableLanguage. A missing value is omitted.
French `hotel.languages_spoken.french`	boolean	availableLanguage	Whether French is spoken at the property. A stated language is included in availableLanguage. A missing value is omitted.
German `hotel.languages_spoken.german`	boolean	availableLanguage	Whether German is spoken at the property. A stated language is included in availableLanguage. A missing value is omitted.
Hindi `hotel.languages_spoken.hindi`	boolean	availableLanguage	Whether Hindi is spoken at the property. A stated language is included in availableLanguage. A missing value is omitted.
Indonesian `hotel.languages_spoken.indonesian`	boolean	availableLanguage	Whether Indonesian is spoken at the property. A stated language is included in availableLanguage. A missing value is omitted.
Italian `hotel.languages_spoken.italian`	boolean	availableLanguage	Whether Italian is spoken at the property. A stated language is included in availableLanguage. A missing value is omitted.
Japanese `hotel.languages_spoken.japanese`	boolean	availableLanguage	Whether Japanese is spoken at the property. A stated language is included in availableLanguage. A missing value is omitted.
Korean `hotel.languages_spoken.korean`	boolean	availableLanguage	Whether Korean is spoken at the property. A stated language is included in availableLanguage. A missing value is omitted.
Mandarin `hotel.languages_spoken.mandarin`	boolean	availableLanguage	Whether Mandarin is spoken at the property. A stated language is included in availableLanguage. A missing value is omitted.
Portuguese `hotel.languages_spoken.portuguese`	boolean	availableLanguage	Whether Portuguese is spoken at the property. A stated language is included in availableLanguage. A missing value is omitted.
Russian `hotel.languages_spoken.russian`	boolean	availableLanguage	Whether Russian is spoken at the property. A stated language is included in availableLanguage. A missing value is omitted.
Spanish `hotel.languages_spoken.spanish`	boolean	availableLanguage	Whether Spanish is spoken at the property. A stated language is included in availableLanguage. A missing value is omitted.
Vietnamese `hotel.languages_spoken.vietnamese`	boolean	availableLanguage	Whether Vietnamese is spoken at the property. A stated language is included in availableLanguage. A missing value is omitted.

2.14 Star classification

Name	Type	Schema.org	Description
Star classification `hotel.classification.stars`	integer	starRating	A hotel star classification from 1 to 5. It is separate from guest reviews and is not a certification unless the issuing organisation is recorded. JSON-LD uses starRating only when that organisation is stated.
Classification issuer `hotel.classification.issuer`	text	—	The organisation that issued the star classification. Without an organisation, the classification is not presented as certified.

2.15 Images

Name	Type	Schema.org	Description
Images `hotel.image.collection`	object	image	An ordered collection of images. Caption, attribution, and a rights note are recorded when they are stated. A missing note stays empty.

2.16 Reputation

Name	Type	Schema.org	Description
Review rating `hotel.review.rating`	number	ratingValue	A guest-review score from one provider. It is not a star classification. A scale is recorded only when that provider states it. The score stays in the native record and is not copied into the core business JSON-LD.
Review count `hotel.review.count`	integer	reviewCount	The number of guest reviews accompanying a review rating from the same provider. It is not calculated from another provider.
Rating count `hotel.review.rating_count`	integer	ratingCount	The number of ratings when the provider states it separately from the number of reviews. It is not calculated from the distribution.
Rating distribution `hotel.review.distribution`	object	—	Numbers recorded against scores 1 to 5. They are not treated as the review count.
Review mentions `hotel.review.mentions`	object	—	Themes mentioned in reviews, with the counts recorded for each theme. This is the optional themes extension of the Reputation component.
Rating scale `hotel.review.scale`	object	—	The lowest and highest points of a review scale, when the scale is stated. Schema.org records the lowest and highest points as separate properties, so this attribute is not given one of them.
Review provider `hotel.review.provider`	text	—	The organisation that published these figures. Figures from another provider are a separate observation and are not averaged together.
Observation date `hotel.review.observed_on`	date	—	The date on which the review statistics were observed, when that date is stated.