Vacation Rental Villa & Holiday Home Schema Markup (JSON-LD)
Structured data for luxury vacation villas, short-term holiday rentals, and private beachfront estates, defining check-in policies, guest occupancy, room setups, and booking offers.
Displayed below main page header or above the tool container. • Zero CLS Container
Production JSON-LD Code Block
Embed this structured data block directly into your HTML <head> or framework layout template.
{
"@context": "https://schema.org",
"@type": "VacationRental",
"@id": "https://example.com/villas/sunset-paradise#villa",
"name": "Sunset Paradise Oceanfront Villa",
"description": "Exclusive 5-bedroom private oceanfront villa featuring private infinity pool, direct beach access, and personal chef services.",
"checkinTime": "15:00",
"checkoutTime": "11:00",
"numberOfBedrooms": 5,
"numberOfBathroomsTotal": 5.5,
"occupancy": {
"@type": "QuantitativeValue",
"maxValue": 12,
"unitCode": "C62"
},
"amenityFeature": [
{
"@type": "LocationFeatureSpecification",
"name": "Private Infinity Pool",
"value": true
},
{
"@type": "LocationFeatureSpecification",
"name": "Direct Beach Access",
"value": true
},
{
"@type": "LocationFeatureSpecification",
"name": "High-Speed Wi-Fi",
"value": true
}
],
"address": {
"@type": "PostalAddress",
"streetAddress": "742 Ocean Boulevard",
"addressLocality": "Kihei",
"addressRegion": "HI",
"postalCode": "96753",
"addressCountry": "US"
},
"offers": {
"@type": "Offer",
"price": "1200",
"priceCurrency": "USD",
"unitText": "NIGHT",
"availability": "https://schema.org/InStock"
}
}Typed Properties Specification (8 Fields)
Key Schema.org properties and sub-objects required to qualify for rich snippet treatment in Google Search.
| Property | Expected Type | Status | Description & Example |
|---|---|---|---|
| name | Text | Required | Descriptive holiday title or brand name of the vacation rental villa. e.g. Sunset Paradise Oceanfront Villa |
| checkinTime | Time | Required | Earliest standard guest check-in time in 24-hour ISO format (HH:MM). e.g. 15:00 |
| checkoutTime | Time | Required | Latest allowable guest check-out time in 24-hour ISO format (HH:MM). e.g. 11:00 |
| numberOfBedrooms | Integer | Required | Total count of dedicated private bedrooms available to guests. e.g. 5 |
| occupancy | QuantitativeValue | Required | Maximum allowable guest capacity with unitCode C62 (individual count). e.g. { "@type": "QuantitativeValue", "maxValue": 12, "unitCode": "C62" } |
| amenityFeature | Array<LocationFeatureSpecification> | Required | Array of premium vacation amenities like swimming pools, hot tubs, beach access, and air conditioning. e.g. [{ "@type": "LocationFeatureSpecification", "name": "Private Infinity Pool", "value": true }] |
| offers | Offer | Required | Nightly rental price, currency code, and booking availability status. e.g. { "@type": "Offer", "price": "1200", "priceCurrency": "USD", "unitText": "NIGHT" } |
| address | PostalAddress | Required | Postal address and geographic municipality of the holiday rental. e.g. { "@type": "PostalAddress", "streetAddress": "742 Ocean Boulevard", ... } |
Google Search Console Pitfalls & Critical Warnings
Avoid these 3 common validation traps, parser errors, and algorithmic policy penalties when deploying VacationRental schema.
Invalid ISO 8601 Time Format on Check-in/Check-out
Specifying check-in times as '3 PM' or '15:00:00 EST' violates Schema.org ISO Time requirements.
Format times strictly as 24-hour 'HH:MM' strings (e.g. '15:00').
Missing Maximum Occupancy Limits
Failing to declare guest capacity limits prevents travel search engines from filtering listings by family/group size.
Provide an occupancy QuantitativeValue object with maxValue.
Misusing Hotel Type for Private Vacation Rentals
Tagging single private standalone homes as '@type: Hotel' leads to missing front desk complaints from search quality evaluators.
Use the specialized VacationRental or House type rather than Hotel.
Recommended Implementation Scenarios
Related Schema Blueprints
Explore complementary structured data blueprints across the Local Business cluster.
Bed & Breakfast and Guesthouse Schema Markup (JSON-LD)
Single Family Residence Sale Schema Markup (JSON-LD)
Campground & RV Park Schema Markup (JSON-LD)
Youth Hostel & Shared Dormitory Schema Markup (JSON-LD)
Displayed below main page header or above the tool container. • Zero CLS Container