Search Console

    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 .

    Troubleshooting

    If you're having trouble implementing or debugging structured data, here are some resources that may help you.

    • If you're using a content management system (CMS) or someone else is taking care of your site, ask them to help you. Make sure to forward any Search Console message that details the issue to them.
    • Google does not guarantee that features that consume structured data will show up in search results. For a list of common reasons why Google may not show your content in a rich result, see the General Structured Data Guidelines .
    • You might have an error in your structured data. Check the list of structured data errors and the Unparsable structured data report .
    • If you received a structured data manual action against your page, the structured data on the page will be ignored (although the page can still appear in Google Search results). To fix structured data issues , use the Manual Actions report .
    • Review the guidelines again to identify if your content isn't compliant with the guidelines. The problem can be caused by either spammy content or spammy markup usage. However, the issue may not be a syntax issue, and so the Rich Results Test won't be able to identify these issues.
    • Troubleshoot missing rich results / drop in total rich results .
    • Allow time for re-crawling and re-indexing. Remember that it may take several days after publishing a page for Google to find and crawl it. For general questions about crawling and indexing, check the Google Search crawling and indexing FAQ .
    • Post a question in the Google Search Central forum .
    Create a Mobile Website
    View Site in Mobile | Classic
    Share by: