How to set up your hotel inventory

Note: You are viewing an article about the Hotel Center. Going forward, the Hotel Center will replace the Hotel Ads Center as the primary feeds interface for your Hotel Ads. If you are still using the Hotel Ads Center, learn more about making the transition to the new Hotel Center experience

This section includes the following topics:


There are 3 basic steps for creating a hotel list:
  1. Setup: We’ll ask questions to determine the best list delivery mode for your hotels.
  2. Manage: This is where you upload your file. It can take up to one hour to process. If you are having uploading issues, contact your account manager.
  3. Publish: After your hotel information is uploaded, you can publish. This can take up to two business days. You'll receive an email notifying you that your hotel information is now live.

For more information on creating an XML-based feed, see Data Feeds Overview.

Listing Requirements

To be eligible for Google Hotel Ads, a property in your hotel list 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

You can include only those properties that meet the above criteria in your hotel list.

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

Data quality

Google attempts to match properties in your hotel list to businesses on Google Maps. If your property has missing or incorrect information, it may not be matched.

Our goal in processing your hotel list is to map your hotel IDs to the canonical listings in Maps. As a result, you can send your hotel IDs in any of our feeds and APIs and we will know which property you are referencing. This is important for updating prices via Transaction messages, or calling our read-only APIs, where you'll be able to use your hotel IDs to write or read information about a specific property.

You can see a list of which hotels are matched and which have data issues on the "Properties" page. Learn more about Resolving property match issues with manual match

You will not be able to advertise unmatched properties. When creating your hotel list, please provide all required fields and ensure that the data is accurate.

Create and manage a hotel list

You can create a hotel list either as a CSV file or XML file. Google recommends that you use the CSV syntax for integrations with static hotels or hotels with a single language. For larger or more advanced configurations, you can use the XML syntax, as described in hotel list XML Reference.

Depending on how frequently you wish to update your hotel information, you can either choose to maintain and upload your hotel list file when you need to make changes, or you can host the hotel list on your website and Google will check it periodically for updates.

If you expect to update your hotel list more than once a month, it is highly recommended to setup an XML feed with Google. Doing so not only increases the accuracy of your hotel information in Hotel Ads, but it also improves the participation rate of your hotels in ad auctions. If your hotel information is in more than one language, it is required to set up an XML feed.

Please contact the Hotel Ads support team for more information if you wish to make changes to your XML feed.

CSV Syntax
A hotel list CSV file consists of a single header row with the names of the columns, plus an additional row for each hotel in the feed.
The first row specifies the names of the columns to be used in the feed. For example:

Not all fields are required. The following table describes each of the available fields:

Column Required? Description
id Required A unique identifier for the hotel. This value must be unique to your site.
name Required The name of the hotel. For example, "Mabel's Gabels".
address Required*

The freeform full address of the hotel. For example, “66 Acacia Avenue, 6th Floor, Suite 610, Boston, Massachusetts, 02467".

Note: If you have already provided addr1, city, state, or postal_code, don't include the address field. Likewise, if you have already provided the address field, don't include the addr1, city, state, or postal code.

addr1 Required The primary street address of the hotel. For example, "66 Acacia Avenue". Note that P.O. boxes or other mailing-only addresses are not considered full physical addresses.
addr2 Optional The optional secondary street address of the hotel. For example, "6th Floor".
addr3 Optional A third optional portion of the street address of the hotel. For example, "Suite 610".
city Required The hotel's city. For example, "London".
province Required The hotel's state, province, or region. For example, "Greater London" or "Massachusetts".
postal_code Required The hotel's postal code. For example, "90210".
country Required The hotel's country. The value must be an ISO 3116 uppercase 2-letter country code. For example, United States is "US" and Canada is "CA".
phone Required* The main voice telephone number for the hotel. For example, "617-867-5309".
latitude Required* The latitude that corresponds to the location of the listing. For example, "37.423738".
longitude Required* The longitude that corresponds to the location of the listing. For example, "-122.090101".
category Optional The category of the hotel. For example, “Hotel”, “Bed and Breakfast”, or “Motel”.
star_rating Optional The hotel class in terms of star ratings. The value must be a whole number between 1 and 5 inclusive or blank. For example, “1” for a one star hotel, “5” for a five star hotel, or “” for an unknown star rating.
hotel_brand Optional The brand to which this hotel belongs. For example, “Marriott” or “Hilton”.
alternate_hotel_id Optional An alternate identifier for your property. Having separate IDs is useful in instances where you might have different property identifiers for your feed information versus booking engine.
custom_0 Optional A custom attribute for grouping hotels in Google Ads campaigns. For example “City Center” or “Beachfront”. There are 5 such fields that can be used in this manner that are not interchangeable. For example, a hotel with custom_0 = “City Center” will not be grouped with a hotel with custom_4 = “City Center”.
custom_1 Optional
custom_2 Optional
custom_3 Optional
custom_4 Optional
*Either a phone number OR latitude/longitude is required. Both are preferred

When specifying data in your feed, keep the following guidelines in mind:

  • Google recommends that you edit the data with Google Sheets, Excel, or other spreadsheet application and export the file as a CSV.
  • The columns can be in any order you choose, but the column names must match the values above.
  • All columns must be separated with a comma.
  • If one of the values contains a comma, you must surround the value with quotes. For example, "Emerson, Lake, and Powell Hotel".
  • If no listings contain a value for a particular column, you can leave out the column (unless it is required).

Freeform addresses

Rather than using separate columns for each part of an address, you can use the address column to specify a "freeform" address. Structured addresses are preferred.

When you specify freeform address values, separate each element with a comma (e.g. "76 Buckingham Palace Road, London, Greater London, SW1W 9TQ").

Note: You must surround the value of the address column with quotes. The quotes help to avoid "Missing street name/number" errors in your hotel list.

The address column replaces the addr1, addr2, addr3, city, province, and postal_code columns. If you specify a freeform address, you must still specify the country column.

CSV examples

The following example shows a simple hotel list with one hotel that includes both the phone and coordinate values: id,name,addr1,city,province,postal_code,country,phone,latitude,longitude

123abc,Belgrave House,76 Buckingham Palace Road,London,Greater London,SW1W 9TQ,UK,123-456-7890,35.070374,-106.213648

The following example shows a hotel that includes coordinate values only (no phone number):


123abc,Belgrave House,76 Buckingham Palace Road,London,Greater London,SW1W 9TQ,UK,35.070374,-106.213648

The following example shows a hotel that uses the freeform address style:


123abc,Belgrave House,"76 Buckingham Palace Road, London, Greater London, SW1W 9TQ",UK,123-456-7890,35.070374,-106.213648

Upload a hotel list

To access the Hotel Center and manually upload your hotel list:

  1. Sign in to your Hotel Center account.
  2. From the navigation menu, select Properties.
  3. Click on Settings.
    • For first time users, answer the setup questions, including the type of file you want to use for your hotel list.
  4. If your requirements match our formatting criteria, upload your CSV or XML file (can take up to 1 hour).
    • You’ll receive a confirmation email when your list is ready to publish. You can adjust your notification settings on the “Account settings” page.
  5. Publish your hotel list (can take up to 2 business days).

After your hotel list feed is processed, check the “Hotel list” page in Hotel Center to see which hotels, if any, did not match. Learn how to resolve property match issues with manual match

Publishing your list

After you have uploaded at least one hotel list, you can choose which one to use as the live version.

To choose the live hotel list:

  1. Sign in to your Hotel Center account.
  2. From the navigation menu, select Properties.
  3. Click on Settings.
  4. On the "Publish" tab, click Publish to set your list live.

You can also restore previous uploads by hovering your mouse over the file name and clicking Republish this file.

Related links

Was this helpful?
How can we improve it?