Vacation rental (VacationRental) structured data

An illustration of vacation rentals in Google Search

When you add structured data to your vacation rental listing pages, Google Search can show your listing in richer ways. Users can see listing information, such as the name, description, images, location, rating, reviews and more right in search results.

Before You Begin

These instructions are intended for sites that have already connected with a Google Technical Account Manager and have access to the Hotel Center. If you are interested in integrating your vacation rental listings but have not yet been contacted by Google, please reach out using the vacation rental interest form.

This feature is limited to sites that meet certain eligibility criteria and additional steps are required to complete the integration. To learn more about how to list your vacation rentals on Google, visit the integration starter guide.

How to add structured data

Structured data is a standardized format for providing information about a page and classifying the page content. If you're new to structured data, you can learn more about how structured data works.

Here's an overview of how to build, test, and release structured data.

  1. Add the required properties. Based on the format you're using, learn where to insert structured data on the page.
  2. Follow the guidelines.
  3. Validate your code using the Rich Results Test and fix any critical errors. Consider also fixing any non-critical issues that may be flagged in the tool, as they can help improve the quality of your structured data (however, this isn't necessary to be eligible for rich results).
  4. Deploy a few pages that include your structured data and use the URL Inspection tool to test how Google sees the page. Be sure that your page is accessible to Google and not blocked by a robots.txt file, the noindex tag, or login requirements. If the page looks okay, you can ask Google to recrawl your URLs.
  5. To keep Google informed of future changes, we recommend that you submit a sitemap. You can automate this with the Search Console Sitemap API.

Example

Here's an example of a simple vacation rental listing using JSON-LD.


<html>
  <head>
    <title>My Beautiful Vacation Rental</title>
    <script type="application/ld+json">
      {
        "@context": "https://schema.org",
        "@type": "VacationRental",
        "additionalType": "HolidayVillageRental",
        "brand": {
          "@type": "Brand",
          "name": "brandIdName"
        },
        "containsPlace": {
          "@type": "Accommodation",
          "additionalType": "EntirePlace",
          "bed": [{
            "@type": "BedDetails",
            "numberOfBeds" : 1,
            "typeOfBed": "Queen"
          },
          {
            "@type": "BedDetails",
            "numberOfBeds" : 2,
            "typeOfBed": "Single"
          }],
         "occupancy": {
            "@type": "QuantitativeValue",
            "value" : 2
          },
          "amenityFeature": [
            {
              "@type": "LocationFeatureSpecification",
              "name": "ac",
              "value": true
            },
            {
              "@type": "LocationFeatureSpecification",
              "name": "airportShuttle",
              "value": true
            },
            {
             "@type": "LocationFeatureSpecification",
              "name": "balcony",
              "value": true
            },
            {
              "@type": "LocationFeatureSpecification",
              "name": "beachAccess",
              "value": true
            },
            {
              "@type": "LocationFeatureSpecification",
              "name": "childFriendly",
              "value": true
            }
          ],
          "floorSize": {
            "@type": "QuantitativeValue",
            "value" : 75,
            "unitCode": "MTK"
          },
          "numberOfBathroomsTotal": 1,
          "numberOfBedrooms": 3,
          "numberOfRooms": 5
        },
        "identifier": "abc123",
        "latitude": "42.12345",
        "longitude": "101.12345",
        "name": "My Beautiful Vacation Rental",
        "address": {
          "addressCountry": "US",
          "addressLocality": "Mountain View",
          "addressRegion": "California",
          "postalCode": "94043",
          "streetAddress": "1600 Amphitheatre Pkwy, Unit 6E"
        },
        "aggregateRating": {
          "ratingValue": 4.5,
          "ratingCount": 10,
          "reviewCount": 3,
          "bestRating": 5
        },
        "image": [
          "https://example.com/mylisting/unit_image1.png",
          "https://example.com/mylisting/unit_image2.png",
          "https://example.com/mylisting/unit_image3.png",
          "https://example.com/mylisting/unit_image4.png",
          "https://example.com/mylisting/unit_image5.png",
          "https://example.com/mylisting/unit_image6.png",
          "https://example.com/mylisting/unit_image7.png",
          "https://example.com/mylisting/unit_image8.png"
        ],
        "checkinTime": "18:00:00+08:00",
        "checkoutTime": "11:00:00+08:00",
        "description": "A great Vacation Rental in the perfect neighborhood.",
        "knowsLanguage": ["en-US", "fr-FR"],
        "review": [{
          "@type": "Review",
          "reviewRating": {
            "@type": "Rating",
            "ratingValue": 4,
            "bestRating": 5
          },
          "author": {
            "@type": "Person",
            "name": "Lillian Ruiz"
          },
          "datePublished": "2024-12-01",
          "contentReferenceTime": "2024-11-17"
        },
        {
          "@type": "Review",
          "reviewRating": {
            "@type": "Rating",
            "ratingValue": 5,
            "bestRating": 5
          },
          "author": {
            "@type": "Person",
            "name": "John S."
          },
          "datePublished": "2024-10-01",
          "contentReferenceTime": "2024-09-28"
        }
      ]
      }
    </script>
  </head>
  <body></body>
  </html>

Eligibility guidelines

You must follow these guidelines for your vacation rental structured data to be eligible for use in Google Search.

Structured data type definitions

The following tables list properties and usage for marking up vacation rental listings using schema.org/VacationRental. You must include the required properties for your structured data to be eligible for display. You can also include the recommended properties to add more information about your content, which will provide a better user experience.

VacationRental

The full definition of VacationRental is available at schema.org/VacationRental.

Required properties
containsPlace

Accommodation

A vacation rental listing must contain one Accommodation to markup additional details such as beds, occupancy, number of rooms, and amenityFeature properties.

containsPlace.occupancy

QuantitativeValue

Information about the maximum number of guests allowed to stay at the vacation rental listing.

"occupancy": {
  "@type": "QuantitativeValue",
  "value" : 5
  }
containsPlace.occupancy.value

Integer

The numerical value of guests allowed to stay at the vacation rental listing.
identifier

Text

A unique identifier for the property.

Additional guidelines:

  • The identifier must be independent of the listing content; for example, it won't change when the property owner updates the listing name or number of bedrooms.
  • The same identifier must be used for the same listing in different languages.
image

Repeated URL

One or more images of the listing. The listing must have a minimum of 8 photos (at least 1 image of each of the following: bedroom, bathroom, and common area).

Additionally, follow the Property listing image requirements.

latitude
(or geo.latitude)

Number

The latitude of the listing's location. Precision must be at least 5 decimal places.

longitude
(or geo.longitude)

Number

The longitude of the listing's location. Precision must be at least 5 decimal places.

name

Text

The name of the vacation rental listing.
Recommended properties
additionalType

Text

The type of vacation rental listing. Here are some suggested values:

  • Apartment
  • Bungalow
  • Cabin
  • Chalet
  • Cottage
  • Gite
  • HolidayVillageRental
  • House
  • Villa
  • VacationRental

The full definitions of these values are in Categories for lodging businesses.

address

PostalAddress

The full, physical location of the vacation rental.

Provide the street address, city, state or region, and postal code for the vacation rental. If applicable, provide the unit or apartment number.

Note that P.O. boxes or other mailing-only addresses are not considered full, physical addresses.

"address": {
  "addressCountry": "US",
  "addressLocality": "Mountain View",
  "addressRegion": "California",
  "postalCode": "94043",
  "streetAddress": "1600 Amphitheatre Pkwy, Apartment 4E"
}
address.addressCountry

Text

The country of your vacation listing, using the two-letter ISO 3166-1 alpha-2 country code.
address.addressLocality

Text

The city of your vacation listing.
address.addressRegion

Text

The name of the listings's state, region, or province.
address.postalCode

Text

The postal code for your vacation listing.
address.streetAddress

Text

The full street address of your vacation listing, including the unit or apartment number if applicable.
aggregateRating

AggregateRating

The average vacation rental rating is based on multiple ratings or reviews. Follow the review snippet guidelines and the list of required and recommended aggregate rating properties.

brand

Brand

The brand ID associated with this property. Read more about how to to associate your properties to brands and how link your brand icons and display names to respective brand IDs in the Hotel Center documentation. 

"brand": {
  "@type": "Brand",
  "name" : "brandIdName"
}
checkinTime

Time

The earliest time someone may check into a lodging establishment in ISO 8601 format.

Example: 14:30:00+08:00
checkoutTime

Time

The latest time someone may check into a lodging establishment in ISO 8601 format.

Example: 14:30:00+08:00
containsPlace.additionalType

Text

The type of room for this accommodation. Use one of the following values:

  • EntirePlace
  • PrivateRoom
  • SharedRoom
containsPlace.amenityFeature

Repeated amenityFeature

Whether the property has a certain feature or amenity. Boolean examples follow this pattern:

"amenityFeature": {
  "@type": "LocationFeatureSpecification",
  "name" : "featureName",
  "value": true
}
 Boolean values

Use one of the following values for the amenityFeature.name property. The values must be in English, even for non-English listings.

ac

Whether the property has air conditioning.
airportShuttle

Whether the host provides transportation to and from airport or other terminals.
balcony

Whether the property has a balcony.
beachAccess

Whether the property has access to a public beach close to the property.
childFriendly

Whether the property is suitable for children.
crib

Whether the property provides a crib.
elevator

Whether the property has an elevator.
fireplace

Whether the property has a fireplace.
freeBreakfast

Whether the property has breakfast included.
gymFitnessEquipment

Whether the property has a gym or fitness equipment.
heating

Whether the property has heating.
hotTub

Whether the property has a hot tub.
instantBookable

Whether the property is instantly bookable through the checkout process. The alternative is waiting for approval.

ironingBoard

Whether the property has ironing boards available.
kitchen

Whether the property has a kitchen.
microwave

Whether the property has a microwave available.
outdoorGrill

Whether the property has a grill.
ovenStove

Whether the property has an oven or a stove.
patio

Whether the property has a patio.
petsAllowed

Whether the guest is allowed to bring a pet to the property.
pool

Whether the property has a pool.
privateBeachAccess

Whether the property has dedicated access to a non-public beach.
selfCheckinCheckout

Whether the property supports self checkin and checkout.
smokingAllowed

Whether smoking is allowed in the unit.
tv

Whether the property has a TV.
washerDryer

Whether the property has laundry appliances.
wheelchairAccessible

Whether the property is wheelchair accessible.
wifi

Whether the property has wifi.

Non-boolean values

We also support the following non-boolean name and value pairs for amenityFeature. Both values must be in English, even for non-English listings.

Non-boolean values follow this pattern:

"amenityFeature": {
  "@type": "LocationFeatureSpecification",
  "name" : "featureName",
  "value": "detail"
  }

internetType

The type of internet available on the property. Here are some suggested values:

  • Free
  • Paid
  • None
"amenityFeature": {
  "@type": "LocationFeatureSpecification",
  "name" : "internetType",
  "value": "Free"
}

parkingType

The type of parking available on the property. Here are some suggested values:

  • Free
  • Paid
  • None

"amenityFeature": {
  "@type": "LocationFeatureSpecification",
  "name" : "parkingType",
  "value": "Free"
}
poolType

The type of pool available on the property. Here are some suggested values:

  • Indoor
  • Outdoor
  • None

"amenityFeature": {
  "@type": "LocationFeatureSpecification",
  "name" : "poolType",
  "value": "Outdoor"
}

licenseNum

The license number (tourist or business) required to be shown for properties in certain regions of the world. It could be repeated and, if multiple licenses exist, we suggest adding the authority of the license as context (for example: Paris: 123456ABC). 

"amenityFeature": {
  "@type": "LocationFeatureSpecification",
  "name" : "licenseNum",
  "value": "Paris: 123456ABC"
}
containsPlace.bed

Repeated BedDetails

Information about the type and number of beds in the listing. 

"bed": [{
  "@type": "BedDetails",
  "numberOfBeds" : 1,
  "typeOfBed": "Queen"
  },
  {
  "@type": "BedDetails",
  "numberOfBeds" : 2,
  "typeOfBed": "Single"
  }]
containsPlace.bed.numberOfBeds

Integer

The number of beds in the listing.

containsPlace.bed.typeOfBed

Text

The type of beds in the listing. Here are some suggested values:

  • CaliforniaKing
  • King
  • Queen
  • Full
  • Double
  • SemiDouble
  • Single
containsPlace.floorSize

QuantitativeValue

Size of the accommodation. It must be specified using unitCode property values:

  • For square feet: FTK or SQFT
  • For square meters: MTK or SQM
"floorSize": {
  "@type": "QuantitativeValue",
  "value" : 75,
  "unitCode": "MTK"
  }
containsPlace.numberOfBathroomsTotal

Integer

The total bathrooms in the listing. Follow real estate conventions as documented in RESO and use the simple sum of the number of bathrooms. For example, for a property with two full bathrooms and one half bathroom, the total number of bathrooms is 2.5.

containsPlace.numberOfBedrooms

Integer

The total number of bedrooms in the listing.
containsPlace.numberOfRooms

Integer

The total number of rooms in the listing.
description

Text

A description of the property.
knowsLanguage

Repeated Text

The languages the host can speak. Use language codes from the IETF BCP 47 standard, such as en-US or fr-FR.

review

Repeated Review

One or more user reviews of the listing. Follow the review snippet guidelines and the list of required and recommended review properties. 

"review": {
  "@type": "Review",
  "reviewRating": {
    "@type": "Rating",
    "ratingValue": 4,
    "bestRating": 5
  },
  "datePublished": "2023-02-09"
  "author": {
    "@type": "Person",
    "name": "Lillian R"
  }
}
review.contentReferenceTime

DateTime

The start date of the author's stay.

Monitor rich results with Search Console

Search Console is a tool that helps you monitor how your pages perform in Google Search. You don't have to sign up for Search Console to be included in Google Search results, but it can help you understand and improve how Google sees your site. We recommend checking Search Console in the following cases:

  1. After deploying structured data for the first time
  2. After releasing new templates or updating your code
  3. Analyzing traffic periodically

After deploying structured data for the first time

After Google has indexed your pages, look for issues using the relevant Rich result status report. Ideally, there will be an increase of valid items, and no increase in invalid items. If you find issues in your structured data:

  1. Fix the invalid items.
  2. Inspect a live URL to check if the issue persists.
  3. Request validation using the status report.

After releasing new templates or updating your code

When you make significant changes to your website, monitor for increases in structured data invalid items.
  • If you see an increase in invalid items, perhaps you rolled out a new template that doesn't work, or your site interacts with the existing template in a new and bad way.
  • If you see a decrease in valid items (not matched by an increase in invalid items), perhaps you are no longer embedding structured data in your pages. Use the URL Inspection tool to learn what is causing the issue.

Analyzing traffic periodically

Analyze your Google Search traffic using the Performance Report. The data will show you how often your page appears as a rich result in Search, how often users click on it and what is the average position you appear on search results. You can also automatically pull these results with the Search Console API.

问题排查

如果您在实施或调试结构化数据时遇到问题，请查看下面列出的一些实用资源。

  • 如果您使用了内容管理系统 (CMS) 或其他人负责管理您的网站，请向其寻求帮助。请务必向其转发列明问题细节的任何 Search Console 消息。
  • Google 不能保证使用结构化数据的功能一定会显示在搜索结果中。如需查看导致 Google 无法将您的内容显示为富媒体搜索结果的各种常见原因，请参阅结构化数据常规指南。
  • 您的结构化数据可能存在错误。请参阅结构化数据错误列表。
  • 如果您的网页受到结构化数据手动操作的影响，其中的结构化数据将会被忽略（但该网页仍可能会出现在 Google 搜索结果中）。如需修正结构化数据问题，请使用“人工处置措施”报告。
  • 再次查看相关指南，确认您的内容是否未遵循指南。问题可能是因为出现垃圾内容或使用垃圾标记导致的。不过，问题可能不是语法问题，因此富媒体搜索结果测试无法识别这些问题。
  • 针对富媒体搜索结果缺失/富媒体搜索结果总数下降进行问题排查。
  • 请等待一段时间，以便 Google 重新抓取您的网页并重新将其编入索引。请注意，网页发布后，Google 可能需要几天时间才会找到和抓取该网页。有关抓取和索引编制的常见问题，请参阅 Google 搜索抓取和索引编制常见问题解答。
  • 在 Google 搜索中心论坛中发帖提问。