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.
Required attributes: capacity and website.
- See example of the direct website link to property in your listing feed. This gives users the opportunity to visit the property website.
Optional (strongly recommended) XML child element: location_precision —default is 500 meters.

For details of required XML child elements, see XML child elements.

For more information about Vacation Rentals, see 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, we will show value for the listing. For example, if we determine from a listing's photos that it has a kitchen, but the kitchen attribute is absent or set to No, we will treat the listing as having a kitchen. These attributes are called "inferred attributes", and they will only be displayed when we are very confident in the accuracy of the inference.

Values for the attribute_name placeholder

This table provides a list of valid values for attribute_name in the <client_attr name="attribute_name"> element; however, partners are encouraged to provide any additional attribute_name they may have.

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
website	Required	The website URL for the property.	Free text
min_days_between_stays	Optional (strongly recommended)	The minimum number of "buffer days" the rental must be empty after the prior occupants depart.	Non-negative integer
enhanced_cleaning_practices	Optional (strongly recommended)	Whether the property uses enhanced cleaning practices with a description on the partner site.	Yes/No/Unknown
partner_hygiene_link	Optional (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	Optional (strongly recommended)	Number of bathrooms.	Non-negative float value, for example, 1, 1.5, 2
number_of_bedrooms	Optional (strongly recommended)	Number of bedrooms.	Non-negative integer value
number_of_beds	Optional (strongly recommended)	Number of beds in all the rooms.	Non-negative integer value
self_checkin_checkout	Optional (strongly recommended)	Whether the property allows for self check-in and check-out.	Yes/No/Unknown
rating	Optional (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	Optional (strongly recommended)	Number of ratings that the property has.	Non-negative integer
ac	Optional	Whether the property has air conditioning.	Yes/No/Unknown
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
beach_access	Optional	Whether the property has access to a public beach close to the property.	Yes/No/Unknown
check_in_time	Optional	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`	Optional	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	Optional	Whether the property is suitable for children.	Yes/No/Unknown
crib	Optional	Whether the property provides a crib.	Yes/No/Unknown
elevator	Optional	Whether the property has an elevator.	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
gym_fitness_equipment	Optional	Whether the property has a gym or any fitness equipment.	Yes/No/Unknown
heating	Optional	Whether the property has heating.	Yes/No/Unknown
hot_tub	Optional	Whether the property has a hot tub.	Yes/No/Unknown
instant_bookable	Optional	Whether the property is instantly bookable through checkout process. The alternative is waiting for approval.	Yes/No/Unknown
ironing_board	Optional	Whether the property has ironing boards available.	Yes/No/Unknown
kitchen	Optional	Whether the property has a kitchen.	Yes/No/Unknown
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
microwave	Optional	Whether the property has a microwave available.	Yes/No/Unknown
minimum_days_advance_purchase	Optional	Minimum number of days in advance that the property can be booked.	Non-negative integer
minimum_night_stay	Optional	Minimum number of nights a guest can book the property.	Positive integer (more than zero)
max_night_stay	Optional	Maximum number of nights a guest can book the property.	Positive integer (more than zero)
number_of_living_rooms	Optional	Number of living rooms.	Non-negative integer value
outdoor_grill	Optional	Whether the property has a grill.	Yes/No/Unknown
oven_stove	Optional	Whether the property has a stove.	Yes/No/Unknown
parking_type	Optional	Type of parking available on the property.	Free/Paid/None
patio	Optional	Whether the property has a patio.	Yes/No/Unknown
pets_allowed	Optional	Some or all rooms allow guests to bring pets—dogs or cats that aren't service animals—with them.	Yes/No/Unknown
pool_type	Optional	Type of pool (pool access) the property has.	Indoors, Outdoors, Indoors/Outdoors, None
private_beach_access	Optional	Whether the property has dedicated access to a non-public beach.	Yes/No/Unknown
room_type	Optional	Type of property being shared with Google. Note: Only accepting entire place for now.	Entire Place, Shared room, Private Room
smoking_free_property	Optional	Whether the property is smoke-free or no smoking allowed.	Yes/No/Unknown
square_footage	Optional	The area of the property in square feet.	Non-negative float value
square_meters	Optional	The area of the property in square meters.	Non-negative float
tv	Optional	Whether the property has a TV.	Yes/No/Unknown
washer_dryer	Optional	Whether the property has laundry appliances.	Yes/No/Unknown
wheelchair_accessible	Optional	Whether the property is wheelchair accessible.	Yes/No/Unknown
internet_type	Optional	Type of Wi-Fi internet access provided by the property.	Free/Paid/None
host_language	Optional	Languages the host can speak.	A comma-separated list of language codes; for example: `de`, `en`

XML child elements

The following XML child elements are required:

Child element	Required?	Type	Description
<country>	Optional (strongly recommended)	string	The country that this listing is located in. The value must be an ISO 3116 uppercase 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.
<location_precision>	Optional (strongly recommended)	integer	Precision of the location of the property sent in meters—usually 500 meters or more—when the property latitude and longitude is obfuscated. The default is 500 meters. Zero means there is no obfuscation and that it is the exact location, and less than 100 meters is considered to be exact. This element applies to Vacation Rentals only.
<name>	Required	string	The name of the property. At most 300 characters.

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">Detailed Address</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>
    <location_precision>500</location_precision>
    <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="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="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="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="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="smoking_free_property">Yes</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>