Hotel List Feed XML Reference

The Hotel List Feed is an XML file that lists all hotels for which you will provide pricing information. The Hotel List Feed itself does not contain pricing information.

The root element of a Hotel List Feed is the <listings> element. This element contains <listing> elements that describe your properties.

You create a Hotel List Feed as part of your initial implementation, and then add or remove hotels from it as part of regular maintenance.

After creating a Hotel List Feed, you can upload it to Google using the Hotel List Feed Upload Tool in the Hotel Ads Center.

Listing requirements

To be eligible for Google Hotel Ads, a property in your Hotel List Feed must have the following:

  • Rooms in which paying guests can stay
  • A physical presence and fixed location that is open to the public
  • A staffed front desk open during normal business hours
  • A minimum stay requirement of no greater than 7 days

Common examples of ineligible properties include cruises, vacation rentals, and apartments because they usually don't meet the above criteria.

<content>

Adds information about a listing, such as ratings and reviews, amenities, and other details. The <content> element is optional. Within <content>, all child elements are optional.

The <content> element appears in the following place in the Hotel List Feed XML hierarchy:

+ <listings>
    + <language>
    + <listing>
        + <content>

<content> syntax

The <content> element uses the following syntax:

Syntax

<?xml version="1.0" encoding="UTF-8"?>
<listings ... >
  <listing>
    <content>
      <text type="description">
        <link>listing_link</link>
        <title>listing_title</title>
        <body>listing_description</body>
      </text>
      <!-- 0 or more reviews: -->
      <review type="[editorial|user]">
        ...
      </review>
      <!-- 0 or more attributes: -->
      <attributes>
        <attr name="air_conditioned">[No|Yes]</attr>
        <attr name="all_inclusive_available">[No|Yes]</attr>
        <attr name="child_friendly">[No|Yes]</attr>
        <attr name="has_affiliated_golf_course">[No|Yes]</attr>
        <attr name="has_airport_shuttle">[No|Yes]</attr>
        <attr name="has_bar_or_lounge">[No|Yes]</attr>
        <attr name="has_beach_access">[No|Yes]</attr>
        <attr name="has_business_center">[No|Yes]</attr>
        <attr name="has_fitness_center">[No|Yes]</attr>
        <attr name="has_free_breakfast">[No|Yes]</attr>
        <attr name="has_hot_tub">[No|Yes]</attr>
        <attr name="has_laundry_service">[No|Yes]</attr>
        <attr name="has_restaurant">[No|Yes]</attr>
        <attr name="has_room_service">[No|Yes]</attr>
        <attr name="has_spa">[No|Yes]</attr>
        <attr name="kitchen_availability">[Available in all rooms|Available in some rooms|
          Not available]</attr>
        <attr name="number_of_rooms">rooms_per_unit</attr>
        <attr name="num_reviews">number_of_reviews</attr>
        <attr name="parking_type">[No payment required|Paid|Not available]</attr>
        <attr name="pets_allowed">[No|Yes]</attr>
        <attr name="rating">aggregate_rating</attr>
        <attr name="rating_stars">[1|2|3|4|5]</attr>
        <attr name="smoke_free_property">[No|Yes]</attr>
        <attr name="swimming_pool_type">[Indoors|Outdoors|Indoors and outdoors|Not available]</attr>
        <attr name="wheelchair_accessible">[No|Yes]</attr>
        <attr name="wifi_type">[Not available|No payment required|Paid]</attr>
      </attributes>
    </content>
  </listing>
  ...
</listings>

<content> attributes

The <content> element has no attributes.

<content> child elements

The <content> element has the following child elements:

Child Element Required? Type Description
<text type="description"> Optional Object Contains the website description of the listing. This element can contain the following child elements (all are optional):

  • <link>: A link to the listing. Include the "http://" or "https://" in this element.
  • <title>: The title for the listing.
  • <description>: A description of the listing.
<review type="[editorial|user]"> Optional <review> Contains a user review or an editorial review of the listing. Your listing can have any number of reviews in it, of either type.

You do not need to include all reviews for a property in your <listing> element; this element is intended for you to include selected reviews that illustrate this listing's features or quality.

<attributes> Optional Object Contains 0 or more <attr> child elements that provide details about the property. The child elements use the following syntax:

<attr name="attribute_name">attribute_value</attr>

For a list of possible child elements, see <content> syntax.

The following child elements take special values not shown in the syntax:

  • "number_of_rooms": A non-negative integer representing the total number of rooms per unit for this listing. This includes bedrooms, but also other living spaces such as a den or kitchen. Does not include bathrooms. For example, "5".
  • "num_reviews": A non-negative integer representing the number of reviews that this listing has received. For example, "32". This number does not need to equal the number of <review> elements in the <listing>.
  • "rating": A floating point number representing the aggregated quality score of this listing. For example, "6.875". This number does not need to be the average of <review> ratings. This number is typically from 0-5, 0-10, or 0-100, but you can use whatever range reflects your rating system.
  • "rating_stars": The number of stars given to this listing from a rating organization; can be "1", "2", "3", "4", or "5".

All <attr> elements are optional.

<content> examples

Example 1

The following example shows a partial Hotel List Feed that includes the <content> element:

<?xml version="1.0" encoding="UTF-8"?>
<listings xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:noNamespaceSchemaLocation="http://www.gstatic.com/localfeed/local_feed.xsd">
  <language>en</language>
  <listing>
    <id>123456</id>
    <name>My Apartment</name>
    <address format="simple">
      <component name="addr1">1 Sandstone Building</component>
      <component name="city">Los Angeles</component>
      <component name="postal_code">90210</component>
      <component name="province">CA</component>
    </address>
    <country>US</country>
    <latitude>40.730610</latitude>
    <longitude>-73.935242</longitude>
    <phone type="main">12345678</phone>
    <date month="7" day="23" year="2017"/>
    <content>
      <text type="description">
        <link>https://examplelisting.com/listings/12345</link>
        <title>3 bedrooms with ocean views</title>
        <body>Stay in this newly renovated 3BR house with ocean views.</body>
      </text>
      <review type="editorial">
        <link>https://example.com/reviews/42</link>
        <title>A little piece of heaven</title>
        <author>EXAMPLE.COM</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"/>
      </review>
      <attributes>
        <attr name="rating">8.2</attr>
        <attr name="star_rating">4</attr>
        <attr name="num_reviews">14</attr>
        <attr name="air_conditioned">Yes</attr>
        <attr name="has_beach_access">No</attr>
        <attr name="has_free_breakfast">Yes</attr>
        <attr name="has_spa">No</attr>
        <attr name="number_of_rooms">5</attr>
        <attr name="pets_allowed">Yes</attr>
        <attr name="wheelchair_accessible">Yes</attr>
        <attr name="kitchen_availability">Available in all rooms</attr>
        <attr name="parking_type">No payment required</attr>
        <attr name="swimming_pool_type">Indoors</attr>
        <attr name="wifi_type">Paid</attr>
      </attributes>
    </content>
  </listing>
  ...
</listings>

<listing>

A hotel definition within a Hotel List Feed's <listings> element.

The <listing> element appears in the following place in the Hotel List Feed XML hierarchy:

+ <listings>
    + <language>
    + <listing>

<listing> syntax

The <listing> element uses the following syntax:

Syntax

<?xml version="1.0" encoding="UTF-8"?>
<listings ... >
  <listing>
    <id>hotel_ID</id>
    <name>hotel_name</name>
    <address>
      <component name="addr1">street_address_1</component>
      <component name="addr2">street_address_2</component>
      <component name="city">city_name</component>
      <component name="province">province_name</component>
      <component name="postal_code">postal_code</component>
    </address>
    <!-- You can also define an address freeform, although this is not recommended: -->
    <!-- <address>freeform_address</address> -->

    <country>country_code</country>
    <latitude>hotel_latitude</latitude>
    <longitude>hotel_longitude</longitude>
    <phone type="[fax|main|mobile|tdd|tollfree]">phone_number</phone>

    <content>content</content>
  </listing>
</listings>

<listing> attributes

The <listing> element has no attributes.

<listing> child elements

The <listing> element has the following child elements:

Child Element Required? Type Description
<address> Required Object or String The full physical location of the hotel.

This element takes a single attribute, format, which you must set to "simple".

At a minimum, you must provide the street address, city, state/region, and postal code for the hotel. Use <component> child elements to describe each of the following parts of the address:

  • addr1: The primary street address of the hotel.
  • addr2: The secondary street address, if necessary.
  • addr3: A third portion of the street address, if necessary.
  • city: The name of the hotel's city.
  • province: The name of the hotel's state, region, or province.
  • postal_code: The hotel's postal code.

For example:

<address format="simple">
  <component name="addr1">666 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 "freeform" address, although this is not recommended. For example:

<address>666 Acacia Ave, Floor 5, Boston, MA, 02472</address>

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

<content> Optional <content> Optional details used for the listing such as a description, ratings, and features of the property.
<country> Required String The country that this listing is located in. The value must be an ISO 3116 uppercase 2-letter country code. For example, United States is "US" and Canada is "CA". For example:

<country>US</country>
<id> Required String A unique identifier for the hotel.

<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 hotel. For example:

<name>Belgrave House</name>
<phone> Required* String One or more contact numbers for the hotel. If the listing is business branch, please provide the phone number specific to branch location (not the phone number of central headquarters).

The type attribute can be one of the following:

  • fax: Fax telephone number.
  • main: Main voice telephone number.
  • mobile: Mobile telephone number.
  • tdd: Telecommunications Device for the Deaf (TDD) telephone number.
  • tollfree: Toll free telephone number.

For example:

<phone type="main">123-456-7890</phone>
<phone type="fax">987-654-3210</phone>

At a minimum, you should provide a main type.

* Either a phone number OR latitude/longitude are required. We recommend that you define both.

<listing> examples

Example 1

The following example shows a partial Hotel List Feed with a structured address:

<?xml version="1.0" encoding="UTF-8"?>
<listings xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:noNamespaceSchemaLocation="http://www.gstatic.com/localfeed/local_feed.xsd">
  <language>en</language>
  <listing>
    <!-- The value of <id> must be unique to your site for all time. Do NOT reuse IDs. -->
    <id>123abc</id>
    <name>Belgrave House</name>
    <address format="simple">
      <component name="addr1">666 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>
    <country>UK</country>
    <latitude>35.070374</latitude>
    <longitude>-106.213648</longitude>
    <phone type="main">123-456-7890</phone>
  </listing>
  ...
</listings>

Example 2

The following example shows a partial Hotel List Feed with a free-form address:

<?xml version="1.0" encoding="UTF-8"?>
<listings xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:noNamespaceSchemaLocation="http://www.gstatic.com/localfeed/local_feed.xsd">
  <language>en</language>
  <listing>
    <!-- The value of <id> must be unique to your site for all time. Do NOT reuse IDs. -->
    <id>123abc</id>
    <name>Belgrave House</name>
    <address>666 Acacia Ave, Floor 5, Boston, MA, 02472</address>
    <country>US</country>
    <latitude>35.070374</latitude>
    <longitude>-106.213648</longitude>
    <phone type="main">123-456-7890</phone>
  </listing>
  ...
</listings>

Example 3

The following example shows a partial Hotel List Feed with a listing that contains an optional <content>:

<?xml version="1.0" encoding="UTF-8"?>
<listings xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:noNamespaceSchemaLocation="http://www.gstatic.com/localfeed/local_feed.xsd">
  <language>en</language>
  <listing>
    <id>123456</id>
    <name>My Apartment</name>
    <address format="simple">
      <component name="addr1">1 Sandstone Building</component>
      <component name="city">Los Angeles</component>
      <component name="postal_code">90210</component>
      <component name="province">CA</component>
    </address>
    <country>US</country>
    <latitude>40.730610</latitude>
    <longitude>-73.935242</longitude>
    <phone type="main">12345678</phone>
    <date month="7" day="23" year="2017"/>
    <content>
      <text type="description">
        <link>https://examplelisting.com/listings/12345</link>
        <title>3 bedrooms with ocean views</title>
        <body>Stay in this newly renovated 3BR house with ocean views.</body>
      </text>
      <review type="editorial">
        <link>https://example.com/reviews/42</link>
        <title>A little piece of heaven</title>
        <author>EXAMPLE.COM</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"/>
      </review>
      <attributes>
        <attr name="rating">8.2</attr>
        <attr name="star_rating">4</attr>
        <attr name="num_reviews">14</attr>
        <attr name="air_conditioned">Yes</attr>
        <attr name="has_beach_access">No</attr>
        <attr name="has_free_breakfast">Yes</attr>
        <attr name="has_spa">No</attr>
        <attr name="number_of_rooms">5</attr>
        <attr name="pets_allowed">Yes</attr>
        <attr name="wheelchair_accessible">Yes</attr>
        <attr name="kitchen_availability">Available in all rooms</attr>
        <attr name="parking_type">No payment required</attr>
        <attr name="swimming_pool_type">Indoors</attr>
        <attr name="wifi_type">Paid</attr>
      </attributes>
    </content>
  </listing>
  ...
</listings>

<listings>

The root element of a Hotel List Feed. Contains a <language> element and at least one <listing>.

The <listings> element appears in the following place in the Hotel List Feed XML hierarchy:

+ <listings>
    + <language>
    + <listing>

<listings> syntax

The <listings> element uses the following syntax:

Syntax

<?xml version="1.0" encoding="UTF-8"?>
<listings xmlns:xsi="xsi"
    xsi:noNamespaceSchemaLocation="schema_xsd">
  <language>language_code</language>
  <listing>listing</listing>
  ...
</listings>

<listings> attributes

The <listings> element has the following attributes:

Attribute Required? Description
xmlns:xsi Required Set to "http://www.w3.org/2001/XMLSchema-instance".
xsi:noNamespaceSchemaLocation Required Set to "http://www.gstatic.com/localfeed/local_feed.xsd".

<listings> child elements

The <listings> element has the following child elements:

Child Element Required? Type Description
<language> Required String The language in which your feed is written. Set the value of this element to a two-letter language code. For example, "en" for English.
<listing> Required <listing> One or more entries that describe each hotel in the feed. Note that each hotel in the list must have an ID that is unique to your site, and that this ID should never be re-used.

<listings> examples

Example 1

The following example shows a partial Hotel List Feed with a structured address:

<?xml version="1.0" encoding="UTF-8"?>
<listings xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:noNamespaceSchemaLocation="http://www.gstatic.com/localfeed/local_feed.xsd">
  <language>en</language>
  <listing>
    <!-- The value of <id> must be unique to your site for all time. Do NOT reuse IDs. -->
    <id>123abc</id>
    <name>Belgrave House</name>
    <address format="simple">
      <component name="addr1">666 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>
    <country>UK</country>
    <latitude>35.070374</latitude>
    <longitude>-106.213648</longitude>
    <phone type="main">123-456-7890</phone>
  </listing>
  ...
</listings>

Example 2

The following example shows a partial Hotel List Feed with a free-form address:

<?xml version="1.0" encoding="UTF-8"?>
<listings xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:noNamespaceSchemaLocation="http://www.gstatic.com/localfeed/local_feed.xsd">
  <language>en</language>
  <listing>
    <!-- The value of <id> must be unique to your site for all time. Do NOT reuse IDs. -->
    <id>123abc</id>
    <name>Belgrave House</name>
    <address>666 Acacia Ave, Floor 5, Boston, MA, 02472</address>
    <country>US</country>
    <latitude>35.070374</latitude>
    <longitude>-106.213648</longitude>
    <phone type="main">123-456-7890</phone>
  </listing>
  ...
</listings>

Example 3

The following example shows a partial Hotel List Feed with a listing that contains an optional <content>:

<?xml version="1.0" encoding="UTF-8"?>
<listings xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:noNamespaceSchemaLocation="http://www.gstatic.com/localfeed/local_feed.xsd">
  <language>en</language>
  <listing>
    <id>123456</id>
    <name>My Apartment</name>
    <address format="simple">
      <component name="addr1">1 Sandstone Building</component>
      <component name="city">Los Angeles</component>
      <component name="postal_code">90210</component>
      <component name="province">CA</component>
    </address>
    <country>US</country>
    <latitude>40.730610</latitude>
    <longitude>-73.935242</longitude>
    <phone type="main">12345678</phone>
    <date month="7" day="23" year="2017"/>
    <content>
      <text type="description">
        <link>https://examplelisting.com/listings/12345</link>
        <title>3 bedrooms with ocean views</title>
        <body>Stay in this newly renovated 3BR house with ocean views.</body>
      </text>
      <review type="editorial">
        <link>https://example.com/reviews/42</link>
        <title>A little piece of heaven</title>
        <author>EXAMPLE.COM</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"/>
      </review>
      <attributes>
        <attr name="rating">8.2</attr>
        <attr name="star_rating">4</attr>
        <attr name="num_reviews">14</attr>
        <attr name="air_conditioned">Yes</attr>
        <attr name="has_beach_access">No</attr>
        <attr name="has_free_breakfast">Yes</attr>
        <attr name="has_spa">No</attr>
        <attr name="number_of_rooms">5</attr>
        <attr name="pets_allowed">Yes</attr>
        <attr name="wheelchair_accessible">Yes</attr>
        <attr name="kitchen_availability">Available in all rooms</attr>
        <attr name="parking_type">No payment required</attr>
        <attr name="swimming_pool_type">Indoors</attr>
        <attr name="wifi_type">Paid</attr>
      </attributes>
    </content>
  </listing>
  ...
</listings>

<review>

Contains a user review or an editorial review. You do not need to include all reviews for a listing in your <listing> element; this element is intended for you to include selected reviews that are indicative of this listing's features or quality.

The <review> element appears in the following place in the Hotel List Feed XML hierarchy:

+ <listings>
    + <language>
    + <listing>
        + <content>
            + <review>

<review> syntax

The <review> element uses the following syntax:

Syntax

<?xml version="1.0" encoding="UTF-8"?>
<listings ... >
  <listing>
    <content>
      ...
      <review type="editorial">
        <link>review_link</link>
        <title>review_title</title> <!-- Title is for reviews of type "editorial" only -->
        <author>review_author</author>
        <rating>review_rating</rating>
        <body>review_text</body>
      </review>
      <review type="user">
        <link>review_link</link>
        <author>review_author</author>
        <date month="MM" day="DD" year="YYYY"/>  <!-- Date is for reviews of type "user" only -->
        <rating>review_rating</rating>
        <body>review_text</body>
      </review>
    </content>
  </listing>
</listings>

<review> attributes

The <review> element has the following attributes:

Attribute Required? Description
type Required The type of review. Set to one of the following values:

  • "editorial": A review by a website or other reviewing authority.
  • "user": A review by an end user.

<review> child elements

The <review> element has the following child elements:

Child Element Required? Type Description
<author> Optional String The review's author; for example, "Susan von Trapp". This can also be the name of a website or publication in which the review appears if it is uncredited.
<body> Optional String The text of the review. This element should not contain HTML unless it is escaped.
<date month="MM" day="DD" year="YYYY"/> Optional Object (User reviews only) The date of the review, which you specifi with the following attributes of this element:

  • day: The day of the month; for example, "3".
  • month: The month, where 1 = January. For example, "12".
  • year: The four-digit year; for example, "2018".

For example, June 7th, 2017 is written as:

<date month="6" day="7" year="2017"/>
<link> Optional String A link to the review. Include the "http://" or "https://" in this element.
<rating> Optional String A floating point number from 0 to 10 (inclusive) representing the score of the review. For example, "8.9".
<title> Optional String (Editorial reviews only) The title of the review.

Note that <title> is a valid child element of <review> only if the review's type is "editorial", and <date> is only valid if type is "user".

<review> examples

Example 1

The following example shows a partial Hotel List Feed with a listing that contains an editorial and a user review:

<?xml version="1.0" encoding="UTF-8"?>
<listings xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:noNamespaceSchemaLocation="http://www.gstatic.com/localfeed/local_feed.xsd">
  <language>en</language>
  <listing>
    <id>123456</id>
    <name>My Apartment</name>
    <address format="simple">
      <component name="addr1">1 Sandstone Building</component>
      <component name="city">Los Angeles</component>
      <component name="postal_code">90210</component>
      <component name="province">CA</component>
    </address>
    <country>US</country>
    <latitude>40.730610</latitude>
    <longitude>-73.935242</longitude>
    <phone type="main">12345678</phone>
    <date month="7" day="23" year="2017"/>
    <content>
      <text type="description">
        <link>https://examplelisting.com/listings/12345</link>
        <title>3 bedrooms with ocean views</title>
        <body>Stay in this newly renovated 3BR house with ocean views.</body>
      </text>
      <review type="editorial">
        <link>https://example.com/reviews/42</link>
        <title>A little piece of heaven</title>
        <author>EXAMPLE.COM</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"/>
      </review>
      <attributes>
        <attr name="rating">8.2</attr>
        <attr name="star_rating">4</attr>
        <attr name="num_reviews">14</attr>
        <attr name="air_conditioned">Yes</attr>
        <attr name="has_beach_access">No</attr>
        <attr name="has_free_breakfast">Yes</attr>
        <attr name="has_spa">No</attr>
        <attr name="number_of_rooms">5</attr>
        <attr name="pets_allowed">Yes</attr>
        <attr name="wheelchair_accessible">Yes</attr>
        <attr name="kitchen_availability">Available in all rooms</attr>
        <attr name="parking_type">No payment required</attr>
        <attr name="swimming_pool_type">Indoors</attr>
        <attr name="wifi_type">Paid</attr>
      </attributes>
    </content>
  </listing>
  ...
</listings>

Syntax guidelines

When creating an XML-based Hotel List Feed, use the following guidelines:

  • Use UTF-8 encoding. Specify this encoding schema by including the encoding attribute in your XML tag, as shown in the examples below.
  • You can specify data values in your feed with CDATA sections. If you use CDATA sections, do not escape special characters.
  • Use escape codes for data values that are not in CDATA sections, including URLs. You can use either the entity code or the character code to represent these special characters.

    The following table lists common entity and character codes you can use:

    Character Entity Character Code
    Ampersand (&) &amp; &#38;
    Single Quote (') &apos; &#39;
    Double Quote (") &quot; &#34;
    Greater Than (>) &gt; &#62;
    Less Than (<) &lt; &#60;
  • Omit XML elements that do not contain data. For example, if you do not have the latitude and longitude for a hotel, you should not include empty <latitude/> and <longitude/> elements.
  • Do not use HTML in your XML elements, unless it is escaped.
  • To validate your feed prior to uploading, you can use the local feed XSD "http://www.gstatic.com/localfeed/local_feed.xsd".
  • To use comments in your feed, wrap the comment in <!-- and --> tags, as the following example shows:

    <!-- This is a comment -->
  • Be sure that you close the <date> element in a user <review>. For example:

    <date day="2" month="12" year="2017"/>

Finding and fixing data issues

To find and fix data issues in your Hotel List Feed, you can use the following tools:

Hotel Ads Center:

APIs: