Hotel SEO & AI search
How do you add schema markup to a hotel website?
Short answer
Add a single JSON-LD block to each page that describes your hotel with the schema.org Hotel type: name, address, phone, check-in and check-out times and the amenities guests can see on the page. Mark up only what's visible, keep it identical to your Google Business Profile, and test it after every website change.
By Eric Zwanenburg, Founder · Updated
Founder of Lodging Engine. 700+ hotel video productions and 15+ years in Mexico's hospitality industry. About the author
· 7 min read
Key takeaways
- Use JSON-LD and the most specific type that fits: Hotel, BedAndBreakfast, Resort, Motel, Hostel or VacationRental.
- Only mark up facts that are visible on the same page and match your Google Business Profile.
- Schema helps search engines and AI assistants read your facts; it doesn't guarantee rich results or better rankings.
- Self-published review stars and FAQ rich results won't show for most hotels, so don't build your plan around them.
- Test with Google's Rich Results Test and the Schema Markup Validator after every change to the site.
What is hotel schema markup?
Hotel schema markup is structured data that describes your property in the shared schema.org vocabulary, so search engines can read your facts without guessing. Instead of inferring your address from a footer or your check-in time from a paragraph, a crawler finds them in labelled fields.
Most hotel websites already show this information to guests. Schema simply repeats the same facts in a machine-readable format, usually as a JSON-LD script in the page's HTML. For a deeper explanation of why it matters, see our Academy guide to hotel structured data.
Which schema type should a hotel use?
Use the most specific type that describes your property. schema.org has a LodgingBusiness type with several subtypes:
| Property | schema.org type |
|---|---|
| Hotel or boutique hotel | Hotel |
| Bed and breakfast or guesthouse | BedAndBreakfast |
| Resort | Resort |
| Motel | Motel |
| Hostel | Hostel |
| Villa or apartment rented as a whole | VacationRental |
| Anything else that offers stays | LodgingBusiness |
Pick one type per property. If you run several properties, each one gets its own page and its own block, and the brand is described once as an Organization that the properties point to.
What does a basic Hotel JSON-LD block look like?
A basic block covers identity, location and the facts guests check most. Here is an example for a fictional hotel; replace every value with your own:
{
"@context": "https://schema.org",
"@type": "Hotel",
"@id": "https://www.examplehotel.com/#hotel",
"name": "Hotel Example",
"url": "https://www.examplehotel.com/",
"telephone": "+52 415 000 0000",
"image": ["https://www.examplehotel.com/images/facade.jpg"],
"address": {
"@type": "PostalAddress",
"streetAddress": "Calle Ejemplo 10",
"addressLocality": "San Miguel de Allende",
"addressRegion": "Guanajuato",
"postalCode": "37700",
"addressCountry": "MX"
},
"geo": { "@type": "GeoCoordinates", "latitude": 20.9144, "longitude": -100.7436 },
"checkinTime": "15:00",
"checkoutTime": "12:00",
"petsAllowed": false,
"amenityFeature": [
{ "@type": "LocationFeatureSpecification", "name": "Free Wi-Fi", "value": true },
{ "@type": "LocationFeatureSpecification", "name": "Rooftop terrace", "value": true }
]
}Put this block on your homepage, or on the page that best represents the property. The @id gives the hotel a stable identifier that other blocks on your site can refer to.
How do you mark up rooms and prices?
Use HotelRoom for each room type, linked to the hotel, and add an Offer only when the price on the page is real and current. A room page could carry:
{
"@context": "https://schema.org",
"@type": "HotelRoom",
"name": "King Room with Balcony",
"containedInPlace": { "@id": "https://www.examplehotel.com/#hotel" },
"bed": { "@type": "BedDetails", "numberOfBeds": 1, "typeOfBed": "King" },
"occupancy": { "@type": "QuantitativeValue", "maxValue": 2 },
"amenityFeature": [{ "@type": "LocationFeatureSpecification", "name": "Air conditioning", "value": true }]
}Be careful with prices. Hotel rates change daily and depend on dates, so a fixed price in your markup quickly becomes wrong. Google shows hotel prices from price feeds connected through Hotel Center and its integration partners, not from the markup on your website. If you do show a "from" price on a page, mark it up as an Offer with the same amount and currency the guest sees, and update both together.
Should hotels add FAQPage schema?
Add FAQPage markup only for questions and answers that are visible on the page. Since 2023, Google shows FAQ rich results only for well-known, authoritative government and health websites, so most hotels won't see them in search results.
That doesn't make good FAQs worthless. Clear questions and direct answers on your page help guests, and they give search engines and AI assistants plain facts to work with. The markup is harmless when it matches the visible text; the content is what matters.
What are the most common hotel schema errors?
These are the problems we see most often when we review hotel websites:
- Generic Organization instead of a lodging type. The markup says "this is a company", not "this is a place to stay".
- Details that don't match the page or the Business Profile. An old phone number in the markup, a different spelling of the hotel name, or an address from before a move.
- Markup for things guests can't see. Amenities, prices or reviews that appear only in the code.
- Self-serving review stars. Google doesn't show review snippets for reviews a business publishes about itself on its own site, so marking up your guest reviews with star ratings won't produce stars.
- Leftovers from an old theme or plugin. Two or three conflicting blocks describing the same hotel differently.
- Broken JSON. A missing comma or quote, and the whole block is ignored.
How do you test hotel structured data?
Test every page type after you add markup and after any change to the website. Three tools cover it:
- Google's Rich Results Test shows what Google can read and whether the page is eligible for any rich result.
- The Schema Markup Validator at validator.schema.org checks the markup against the full schema.org vocabulary, including types Google doesn't use for rich results.
- Our free [Structured Data Checker](/academy/tools/structured-data-checker) looks for a lodging type and the hotel properties guests and assistants rely on, and tells you which recommended ones are missing.
After launch, the Enhancements and structured data reports in Google Search Console show errors across the whole site, which is useful after a redesign or a change of website platform.
Does a vacation rental use the same markup?
Mostly, yes. A villa or apartment rented as a whole uses the VacationRental type instead of Hotel, with the same identity and address fields. Describe the property as one unit: the number of bedrooms and bathrooms, the maximum number of guests and the amenities guests can see on the page. If guests book through a request form rather than a booking engine, don't add booking actions or prices that the page doesn't show. Google has separate vacation rental features that use data from its connectivity partners, so the markup on your own site is mainly there to describe the property clearly and consistently.
Does schema markup help with AI search?
Schema can help AI systems read your facts, but there is no special markup for appearing in AI answers. Google says the same SEO foundations apply to its AI features, and that no extra schema or files are needed to be included.
In practice, the facts in your markup should also appear in plain text on your pages, match your Business Profile and the listings on other sites, and stay up to date. When those sources agree, every system that describes your hotel has less to guess. Our Academy explains how structured data relates to AI search in more detail.
Where should you start?
Start with one accurate Hotel block on your homepage, then add room pages and FAQs once the basics are right. A practical order:
- Check what your site already outputs with the Structured Data Checker.
- Remove duplicate or outdated blocks.
- Add one Hotel (or more specific) block with name, address, phone, geo, check-in and check-out times and visible amenities.
- Make sure every value matches your Google Business Profile.
- Add HotelRoom markup to room pages.
- Test, then retest after every change.
If you'd rather have someone else do it, our visibility audit reviews your structured data along with the rest of your site, and our managed websites include correct hotel markup from launch.
Frequently asked questions
Is schema markup a ranking factor for hotels?
Not directly. Schema helps search engines understand your pages and can make them eligible for some search features, but it doesn't push a page up the rankings on its own.
Which format should a hotel use: JSON-LD, Microdata or RDFa?
JSON-LD. Google recommends it, it sits in one script block instead of being woven into your HTML, and it's the easiest to keep correct when the design changes.
Can I show star ratings in Google with review schema?
Not for reviews you publish about your own hotel. Google doesn't show review snippets for self-serving reviews of a business. Your Google rating comes from reviews on your Business Profile.
Do I need schema on every page?
Put the Hotel block on the main property page, and add page-specific markup where it fits: HotelRoom on room pages, FAQPage where a page shows FAQs, BreadcrumbList on deeper pages.
Will Google show my prices from my schema?
Google's hotel prices come from price feeds through Hotel Center and its partners, not from the markup on your site. If you show a price on a page, any Offer markup must match it exactly.
How often should I check my structured data?
After every change to the site, and at least every few months. Redesigns, new plugins and changes of website platform are the usual moments when markup breaks or duplicates.
Sources
- schema.org: Hotel
- schema.org: HotelRoom
- Google Search Central: Introduction to structured data
- Google Search Central: General structured data guidelines
- Google Search Central blog: Changes to HowTo and FAQ rich results (2023)
- Google Search Central blog: Making review rich results more helpful (2019)
- Google Search Central: AI features and your website
- Google Rich Results Test
- Schema Markup Validator
Want a specialist's view of your website?
A free first look at your site, with practical next steps by email within one business day.
Get your free hotel website review