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 direct website link to property 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, 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.

Key Point: For vacation rentals, the amenities are provided through your Hotel List Feed attributes.

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	Non-negative integer value
instant_bookable	Strongly recommended	Whether the property is instantly bookable through checkout 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
minimum_days_advance_purchase	Recommended	Minimum number of days in advance that the property can be booked.	Non-negative integer value
minimum_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	Object or string	The full physical location of the property. This element takes a single attribute, format, which you must set to simple. At a minimum, you must provide the street address, city, state or region, and postal code for the property. Use <component> child elements to describe each of the following parts of the address: addr1: The primary street address of the property. addr2: The secondary street address, including unit number, if necessary. addr3: A third portion of the street address. city: The name of the property's city. province: The name of the property's state, region, or province. postal_code: The property's postal code. For example: <address format="simple"> <component name="addr1">6 Acacia Ave</component> <component name="addr2">Floor 5</component> <component name="city">London</component> <component name="province">Greater London</component> <component name="postal_code">SW1W 9TQ</component> </address> Alternatively, you can provide a "free-form" address, although this is not recommended. For example: <address>6 Elm Ave Unit 3, Boston, MA, 02472</address> Note that P.O. boxes or other mailing-only addresses are not considered full physical addresses.

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="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>