Hotel prices structured data format lets partners add details to their web page so that Google's systems can better understand the information.
You can use structured data to annotate price information on your website, which can help Google improve the accuracy of price validations and perform more checks. Learn more about How Google enforces price accuracy.
Google can only use structured data to improve Price Accuracy checks for partners whose structured data matches the data shown to website users. Partners are expected to verify and monitor the accuracy (or “trustability”) of their structured data implementation using the Hotel Center reports for Price Accuracy checks. If Google detects mismatches between your structured data and your website, structured data won’t be used for price accuracy checks until the mismatches are fixed and trustability is maintained consistently for multiple days.
On this page
- Resources
- Add structured data for prices
- Test and verify your structured data setup
- Check your structured data trustability and view rich results
- Instructions on how to check structured data mismatches in the Hotel Center
- FAQs
Resources
The following resources are available to help you implement and verify Structured Data on your website:
Tool/Content | Usage |
---|---|
RRT Tool: Rich Results Test - Google Search Console | Self-serve tool for partners to debug and verifying their implementation |
Developer website: Hotel Price Structured Data Reference | Detailed data structures and technical implementation information with examples |
Help center and troubleshooting in Hotel Center: About structured data for Hotel ads price accuracy validation | Google Help Center: General and non-technical information on structured data, and troubleshooting in the Hotel Center |
"Contact us" page | Technical support and questions |
Add structured data for prices
To add structured data for hotel prices to your website, you need to edit the code on your landing page URLs where users find their price options. You can follow the Hotel Price Structured Data Reference page in our Developer’s Guide to get started.
Vacation rentals (VR) use the same schema and format for showing markups on their website with added restriction that any VR mandatory attribute or .xml
tag needs to be present. Follow the schema for Vacation rentals structured data.
Test and verify your structured data setup
After you add structured data to your website, you can check your results using Google’s Rich Results Test. The Rich Results Test is a web-based tool provided by Google that helps you test and validate the structured data on your web pages at no cost. The tool analyzes whether your existing code could make your pages eligible for rich results in Google Search. Learn more about Google’s Rich Results Test.
Instructions
- Go to Rich Results Test.
- Select your input method:
- URL: Paste the URL of the web page you want to test. There's always the option to check the code snippet if the URL path shows error connecting to the website.
- Code snippet: Directly paste your HTML code if you’re working on a new or draft content.
- Based on your input method, click Test URL or Test code. The tool will analyze your structured data.
- Review results under the “Hotels” section:
- Eligible Rich Results: The tool will display the rich result types your page could trigger on Google Search.
- Warnings & Errors: The tool will identify any technical errors or warnings. Fix any critical errors showing in the tool.
Google will automatically scan your website for the structured data and validate that the signal is trustworthy for price accuracy checks. This can take several days after you successfully complete your structured data setup. You may notice an increase in price accuracy validations in Hotel Center, indicating your structured data is being used. Learn more about Pricing: Check your price accuracy.
Check your structured data trustability and view rich results
Each validation has a trustability status that displays whether the price Google retrieved from your structured data markup (SDM) matches the price found by our reviewers on the website. As long as there are mismatches, structured data isn’t considered trustable and won’t be used for price validation.
Instructions on how to check structured data mismatches in the Hotel Center
Google expects there are no mismatches between structured data on the website and the prices shown on the websites.
To activate the "Markup trustability" column in Hotel Center:
- Sign in to your Hotel Center account.
- In the left menu, click the Pricing tab.
- Click the 3-dot icon
in the upper-right corner of the “Pricing” table at the bottom of the page, then select Manage columns.
- In the “Manage Columns” pop-up, select the Markup trustability checkbox.
- Click Update.
To filter by structured data trustability mismatch issues:
- Click Add a filter, then select Markup trustability from the dropdown.
- Use the filter to check for prices where the trustability signal is either Disagree or No markup found or Incorrect Dates to identify issues.
- Remove the "Price match excluding = Yes" and "Affects score = Yes" filters.
- Select the rate you want to investigate, then click on the screenshot with the price.
- Select the first screenshot.
- In the upper-left corner of the screenshot, click the View HTML in Rich Result Test button to be redirected to the Rich Results debug page.
Markup trustability status | Description |
TRUSTABILITY_AGREE | This means that the price markup on your landing page matches the price you show to users. |
TRUSTABILITY_DISAGREE | This means that the price markup on your landing page does not match the price you show to users. |
Markup trustability not found | This means that we checked your landing page structured data but did not find any markup information for this itinerary. |
TRUSTABILITY_UNKNOWN | This means we haven't checked your structured data or that instance is irrelevant. |