Attributes

This page covers the descriptions, values, and requirements for attributes and child elements. These values are only applicable to Vacation Rentals properties.

The general XML structure has a similar format as Hotel listing feeds. See Hotel list XML reference.

Failure to include the following required items automatically disables the listing:

  • Required XML child elements: id, name, latitude, longitude, address.
  • Required attributes: capacity and website. Refer to the Vacation rentals direct links in your listing feed. This gives users the opportunity to visit the property website.

For details of required XML child elements, refer to XML child elements.

For more information about Vacation Rentals, refer to Attributes unique to Vacation Rentals.

Finally, when Google determines from other sources that the value of an attribute is different from what is specified in the feed for a vacation rental listing, Google displays the value for the listing. For example, if Google determines from a listing's photos that it has a kitchen, but the kitchen attribute is absent or set to No, Google treats the listing as having a kitchen. These attributes are called "inferred attributes", and they are displayed only when there is high confidence in the inference accuracy.

Values for the attribute_name placeholder

The following table provides a list of valid values for attribute_name in the <client_attr name="attribute_name"> element; however, it is recommended that you provide your additional attribute_name if available.

Values for attribute_name Required? Description Valid content values
capacity Required Maximum number of guests the property can accommodate. This value should be equal to or greater than "number_of_bedrooms." Non-negative integer value
website Required The website URL for the property. Free text
partner_hygiene_link Strongly recommended Link to external partner site providing more information about the hygiene details of the listing. Free text (the site's URL)
number_of_bathrooms Strongly recommended Number of bathrooms. Non-negative float value, for example, 1, 1.5, 2
number_of_bedrooms Strongly recommended Number of bedrooms. Non-negative integer value
number_of_beds Strongly recommended Number of beds in all the rooms. Non-negative integer value
self_checkin_checkout Recommended Whether the property allows for self check-in and check-out. Yes/No/Unknown
rating Strongly recommended A floating point number representing the aggregate property rating. This number is typically from 0-5, 0-10, or 0-100, but you can use any range that represents your rating system. Non-negative float value
rating_num Strongly recommended Number of ratings that the property has. Non-negative integer value
rating_scale Strongly recommended Maximum rating possible for a property. For example, the property rating should be 3 or 4 for a rating_scale of 5.

Note: The default rating_scale is 0-10 if unspecified.

Non-negative integer value
instant_bookable Strongly recommended Whether the property is instantly bookable through check-out process. The alternative is waiting for approval. Yes/No/Unknown
description Strongly recommended Freeform text describing the unique qualities of the property Free text
category Strongly recommended The type of property, such as a villa, bungalow, cabin, or apartment Free text
ac Recommended Whether the property has air conditioning. Yes/No/Unknown
beach_access Recommended Whether the property has access to a public beach close to the property. Yes/No/Unknown
check_in_time Recommended Exact time of day for check-in to property. HHMM, HH:MM, or HH:MM:SS format accepted; for example, use 14:00 instead of 2pm or 2:00pm. All other formats won't be parsed or shown. Time
check_out_time Recommended Exact time of day for check-out from property. HHMM, HH:MM, or HH:MM:SS format accepted; for example, use 11:00 instead of 11am or 11:00am. All other formats won't be parsed or shown. Time
child_friendly Recommended Whether the property is suitable for children. Yes/No/Unknown
crib Recommended Whether the property provides a crib. Yes/No/Unknown
elevator Recommended Whether the property has an elevator. Yes/No/Unknown
gym_fitness_equipment Recommended Whether the property has a gym or any fitness equipment. Yes/No/Unknown
heating Recommended Whether the property has heating. Yes/No/Unknown
hot_tub Recommended Whether the property has a hot tub. Yes/No/Unknown
ironing_board Recommended Whether the property has ironing boards available. Yes/No/Unknown
kitchen Recommended Whether the property has a kitchen. Yes/No/Unknown
microwave Recommended Whether the property has a microwave available. Yes/No/Unknown
min_days_advance_purchase Recommended Minimum number of days in advance that the property can be booked. Non-negative integer value
min_night_stay Recommended Minimum number of nights a guest can book the property. Positive integer (more than zero)
max_night_stay Recommended Maximum number of nights a guest can book the property. Positive integer (more than zero)
outdoor_grill Recommended Whether the property has a grill. Yes/No/Unknown
oven_stove Recommended Whether the property has a stove. Yes/No/Unknown
parking_type Recommended Type of parking available on the property. Free/Paid/None
patio Recommended Whether the property has a patio. Yes/No/Unknown
pets_allowed Recommended Some or all rooms allow guests to bring pets—dogs or cats that aren't service animals—with them. Yes/No/Unknown
pool_type Recommended Type of pool (pool access) the property has. Indoors, Outdoors, Indoors/Outdoors, None
smoking_free_property Recommended Whether the property is smoke-free or no smoking allowed. Yes/No/Unknown
special_service_level Recommended Whether the service level of the listing is special in some way. For example, verified, luxury, premium Yes/No/Unknown
square_footage Recommended The area of the property in square feet. Non-negative float value
square_meters Recommended The area of the property in square meters. Non-negative float
tv Recommended Whether the property has a TV. Yes/No/Unknown
washer_dryer Recommended Whether the property has laundry appliances. Yes/No/Unknown
wheelchair_accessible Recommended Whether the property is wheelchair accessible. Yes/No/Unknown
internet_type Recommended Type of Wi-Fi internet access provided by the property. Free/Paid/None
airport_shuttle Optional Whether the host provides transportation to or from airport or other terminals. Yes/No/Unknown
balcony Optional Whether the property has a balcony. Yes/No/Unknown
fire_place Optional Whether the property has a fireplace. Yes/No/Unknown
free_breakfast Optional Whether the property has free breakfast included. Yes/No/Unknown
host_description Optional Description of the vacation rental host. Free text
host_language Optional Languages the host can speak. A comma-separated list of language codes; for example: de, en
host_name Optional Name of the vacation rental host. Free text
host_response_rate Optional Average response rate of the host. Non-negative float value, for example, 1, 0.75, 0.5
host_response_time Optional Average response time of the host. Free text
license_num Optional 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 authority of the license as context; for example: "Paris: 123456ABC". Free text
number_of_half_bathrooms Optional Number of half bathrooms. Non-negative integer value
number_of_living_rooms Optional Number of living rooms. Non-negative integer value
private_beach_access Optional Whether the property has dedicated access to a non-public beach. Yes/No/Unknown
refund_policy Optional Refund policy for the property. Free text

XML child elements

The following XML child elements are required:

Child element Required? Type Description
<country> Strongly recommended string The country that this listing is located in. The value must be an ISO 3116 2-letter country code; for example, the United States is US and Canada is CA: 
    <country>US</country>
<id> Required string The unique identifier for the property. Note that each vacation rental must have an ID that is unique to your site, and this ID should never be reused.
<latitude> Required float The latitude that corresponds to the location of the listing. For example: 
    <latitude>37.423738</latitude>

This value can be generated with GeoCoding tools like the Google Maps API.
<longitude> Required float The longitude that corresponds to the location of the listing. For example: 
    <longitude>-122.090101</longitude>

This value can be generated with GeoCoding tools like the Google Maps API.
<name> Required string The name of the property. At most 300 characters.
<address> Required string or Object

The full physical location of the property as a string. The address must include a street name and number. If none exists, the address should include a plus code. Apartment or unit numbers must also be included if applicable.

Alternatively, you can provide a "composite" address. Use <component> child elements to describe each of the following parts of the address:

  • addr1: The primary street address.
  • addr2: If necessary, the secondary street address, including the unit number.
  • city: The city.
  • province: If necessary, the state, region, or province.
  • postal_code: The postal code.
  • country: The country.

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

Here are examples of a complete address:

<address>6 Acacia Ave Apt. 2, Nottingham NG8 6FT, UK/address>
 
<address>
  <component name="addr1">6 Acacia Ave</component>
  <component name="addr2">Apt. 2</component>
  <component name="city">Nottingham </component>
  <component name="postal_code">NG8 6FT</component>
  <component name="country">UK</component>
</address>

Here are examples of a complete address using a plus code:

<address>XQHM+7VF Nottingham NG8 6FT, UK/address>
 
<address>
  <component name="addr1">XQHM+7VF</component>
  <component name="city">Nottingham </component>
  <component name="postal_code">NG8 6FT</component>
  <component name="country">UK</component>
</address>

Avoid the following:

  • Redundant info: Don't include extraneous information or repeat address components.
  • Missing street address: Addresses must have a street name and number.

Vacation Rentals listing example

<?xml version="1.0" encoding="UTF-8"?>
<listings>
  <language>en</language>
  <listing>
    <id>123456</id>
    <name>Apartment Name</name>
    <address format="simple">
      <component name="addr1">18733 Clark Way</component>
      <component name="addr2">#C10</component>
      <component name="city">Mountain View</component>
      <component name="postal_code">94043</component>
      <component name="province">California</component>
    </address>
    <country>US</country>
    <latitude>37.4182515</latitude>
    <longitude>-122.0742354</longitude>
    <phone type="main">12345678</phone>
    <category>vacation_villa</category>
    <date day="21" month="12" year="2017"/>
    <content>
      <text type="description">
        <link>https://list_url</link>
        <title>Description Title</title>
        <body>Description Body</body>
      </text>
      <review type="editorial">
        <link>https://example.com/reviews/42</link>
        <title>A little piece of heaven</title>
        <author>EXAMPLE</author>
        <rating>8</rating>
        <body>This place is really good.</body>
      </review>
      <review type="user">
        <link>https://exampleperson.org/reviews/82</link>
        <author>Susan von Trapp</author>
        <rating>6</rating>
        <body>Not a bad place, but I prefer to be closer to the beach.</body>
        <date day="6" month="7" year="2017"/>
        <servicedate day="16" month="6" year="2017"/>
      </review>
      <attributes>
        <website>https://hotel.example.com/123456</website>
        <client_attr name="capacity">7</client_attr>
        <client_attr name="cleaning_disinfection">Yes</client_attr>
        <client_attr name="min_days_between_stays">3</client_attr>
        <client_attr name="enhanced_cleaning_practices">Yes</client_attr>
        <client_attr name="partner_hygiene_link">http://www.example.com/hygiene/</client_attr>
        <client_attr name="number_of_bathrooms">2</client_attr>
        <client_attr name="number_of_bedrooms">3</client_attr>
        <client_attr name="number_of_beds">4</client_attr>
        <client_attr name="self_checkin_checkout">Yes</client_attr>
        <client_attr name="rating">4.8</client_attr>
        <client_attr name="rating_num">5373</client_attr>
        <client_attr name="rating_scale">5</client_attr>
        <client_attr name="ac">Yes</client_attr>
        <client_attr name="airport_shuttle">Yes</client_attr>
        <client_attr name="balcony">No</client_attr>
        <client_attr name="beach_access">Yes</client_attr>
        <client_attr name="check_in_time">15:00</client_attr>
        <client_attr name="check_out_time">11:00</client_attr>
        <client_attr name="child_friendly">Yes</client_attr>
        <client_attr name="crib">Unknown</client_attr>
        <client_attr name="elevator">Yes</client_attr>
        <client_attr name="fire_place">Unknown</client_attr>
        <client_attr name="free_breakfast">Yes</client_attr>
        <client_attr name="gym_fitness_equipment">Yes</client_attr>
        <client_attr name="heating">Yes</client_attr>
        <client_attr name="host_description">A short description about the host and their interests</client_attr>
        <client_attr name="host_name">The name of the host</client_attr>
        <client_attr name="host_language">en, da, el</client_attr>
        <client_attr name="host_response_rate">0.75</client_attr>
        <client_attr name="host_response_time">1 hour</client_attr>
        <client_attr name="hot_tub">Yes</client_attr>
        <client_attr name="instant_bookable">Yes</client_attr>
        <client_attr name="internet_type">Free</client_attr>
        <client_attr name="ironing_board">No</client_attr>
        <client_attr name="kitchen">Yes</client_attr>
        <client_attr name="license_num">Free text. If multiple licenses exist, we suggest adding authority of the licence as context</client_attr>
        <client_attr name="license_num">Paris: 123456ABC</client_attr>
        <client_attr name="microwave">Yes</client_attr>
        <client_attr name="max_night_stay">7</client_attr>
        <client_attr name="min_days_advance_purchase">2</client_attr>
        <client_attr name="min_night_stay">3</client_attr>
        <client_attr name="number_of_living_rooms">1</client_attr>
        <client_attr name="outdoor_grill">No</client_attr>
        <client_attr name="oven_stove">Yes</client_attr>
        <client_attr name="parking_type">Free</client_attr>
        <client_attr name="patio">Unknown</client_attr>
        <client_attr name="pets_allowed">Yes</client_attr>
        <client_attr name="pool_type">Indoors</client_attr>
        <client_attr name="private_beach_access">Unknown</client_attr>
        <client_attr name="room_type">Entire Place</client_attr>
        <client_attr name="refund_policy">The refund policy for the property</client_attr>
        <client_attr name="smoking_free_property">Yes</client_attr>
        <client_attr name="special_service_level">No</client_attr>
        <client_attr name="square_footage">1200</client_attr>
        <client_attr name="tv">Yes</client_attr>
        <client_attr name="washer_dryer">Yes</client_attr>
        <client_attr name="wheelchair_accessible">Yes</client_attr>
      </attributes>
    </content>
  </listing>
</listings>