From W3C Wiki
Jump to: navigation, search

1. Vacation Rental Schema

1.1 Scope

The scope of the Vacation Rental Schema is to differentiate this accomodation type from other accomodation types that are currently marked up. The most relevant Schema.org mark-ups to this industry right now are the following:


According to Wikipedia[1], Vacation rental is the renting out of a furnished apartment or house on a temporary basis to tourists as an alternative to a hotel. The term vacation rental is mainly used in the US. In Europe the term villa rental or villa holiday is preferred for rentals of detached houses in warm climates. Other terms used are self-catering rentals, holiday homes, holiday lets (in the United Kingdom), cottage holidays (for rentals of smaller accommodation in rural locations) and gites (in rural locations in France.

This accommodation type definitely differs from Hotels, Hostels, Motels and B&Bs and it's certainly a sub-category of the LodgingBusiness schema with a few extra features, as described below.

1.2 Vacation Rental Schema properties

Below, you can find the complete proposal for properties that are needed for a complete Vacation Rental Schema. The first three tables have properties that are shared by other Schemas (Place, Thing and LocalBusiness) while the fourth table includes the new elements that need to be included to the schema in order to give the characteristics of the vacation rental industry.

Properties from other Schemas:

PropertyExpected TypeDescription
Properties from Place[2]  
addressPostalAddressPhysical address of the item.
aggregateRatingaggregateRatingThe overall rating, based on a collection of reviews or ratings, of the item.
geoGeoCoordinates or GeoShapeThe geo coordinates of the place.
mapURLA URL to a map of the place.
photosImageObject or PhotographPhotographs of this place
reviewsReviewReview of the item
telephoneTextThe telephone number.
Properties from Thing[3]  
descriptionTextA short description of the item.
imageURLURL of an image of the item.
nameTextThe name of the item.
urlURLURL of the item.
Properties from LocalBusiness[4]  
priceRangeTextThe price range of the business, for example $$$.
paymentAcceptedTextCash, credit card, etc.
currenciesAcceptedTextThe currency accepted (in ISO 4217 currency format).

New properties for the Vacation Rental Schema - Proposed Vocabulary

PropertyExpected TypeDescription
propertyIDTextProperty unique identifier: E.g. 127254, 54362vr, etc.
propertyTypeTextProperty type: Apartment, boat house, villa, farm house, etc.
sizeTextE.g. 800ft2 / 74m2
accommodationTypeTextAccommodation type: Catered, etc.
locationTypeTextLocation type: Beach, Mountain, City Center, Village, Ski resort etc
facilitiesTextFacilities / amenities: Air conditioning, parking, garden, WiFi etc
bedroomsnumber# of bedrooms: 1,2,3
bathroomsnumber# of bathrooms: 1,2,3
canAccommodatenumberNumber of people - "Sleeps"
minimumNightsnumberMinimum number of days accepted for a booking (length). Ie. 3 (or 0 for no limit)
advancedBookingsnumberHow far ahead will a booking be accepted. Number of days - ie. 90 (or 0 for no limit)
neighbourhoodText/URLImportant places that are nearby?
cancellationPolicyTextCancellation policy: Are cancellations accepted? Refunds offered? Period in days and conditions.

1.3 Possible Implementations

The vacation rental industry is quite big. Companies like HomeAway, Connecting Rentals Worldwide, Homelidays, OwnersDirect, Toprural, TripAdvisor, VRBO, Flipkey, aura.travel, etc. are possible adopters.