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
andwebsite
. 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
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:
|
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>