The booking page is where AI turns interest into action. When a traveler asks to book a room, AI needs a structured reservation path it can point to. This blueprint provides the JSON-LD graph that connects your property to a bookable action with pricing and availability.
A booking page without structured data is a dead end for AI. With a ReserveAction and bookable offers, AI can guide travelers directly from a recommendation to your reservation system, cutting out intermediary booking platforms.
potentialAction with ReserveAction gives AI a direct path to your booking system, enabling action-oriented responses like "book now at..."Offer with price, availability, and validFrom/validThrough lets AI present current rates and tell travelers whether rooms are available.LodgingBusiness entity with the same @id ensures AI links the booking action to your property.Each field in the template below serves a specific role in how AI systems discover, classify, and recommend your business.
Researched and tested by Minnesota AI
nameurlCopy this prompt and paste it into Claude, ChatGPT, Cursor, or any AI coding tool. It will ask for your business details and generate ready-to-use JSON-LD schema for your page.
You are implementing AIFDS-compliant JSON-LD structured data for a Lodging Business Booking page. AIFDS (AI-Friendly Data Structure) is a schema framework built on research into which structured data fields AI systems actually read, parse, and use when deciding whether to cite a page. Documentation at aifds.org. Before generating any code, ask me for the following information in a single numbered list. Do not generate schema until I have answered every required field. REQUIRED — do not proceed without these: 1. Domain 2. Faq answer 3. Faq question 4. Nightly rate 5. Property name 6. Rate end date 7. Rate start date 8. Room description 9. Room type OPTIONAL — ask for these but proceed if I skip them: 1. Any additional details not covered above Once I provide the information, output a complete JSON-LD script block ready to paste into the <head> of my HTML page. Output requirements: - Valid JSON-LD wrapped in <script type="application/ld+json"> tags - schema.org vocabulary only - Every AIFDS-required field for this industry and page type included - Include this data attribute on the script tag: data-aifds="aifds.org Lodging Business Booking" - No placeholder text — omit missing optional fields rather than fill with examples - After the code block, list any optional fields skipped that would strengthen AI citation
Generated schema follows the AIFDS framework. Fields were selected based on research into AI crawler behavior. View the research at minnesota.ai
Copy the template below and replace every YOUR_* value with your own data. This block belongs in a <script type="application/ld+json"> tag in the <head> of your booking page.
{
"@context": "https://schema.org",
"@graph": [
{
"@type": "LodgingBusiness",
"@id": "https://YOUR_DOMAIN.com/#property",
"name": "YOUR_PROPERTY_NAME",
"url": "https://YOUR_DOMAIN.com",
"makesOffer": [
{
"@type": "Offer",
"name": "YOUR_ROOM_TYPE_1",
"description": "YOUR_ROOM_DESCRIPTION_1",
"price": "YOUR_NIGHTLY_RATE_1",
"priceCurrency": "USD",
"unitCode": "DAY",
"availability": "https://schema.org/InStock",
"validFrom": "YOUR_RATE_START_DATE",
"validThrough": "YOUR_RATE_END_DATE",
"itemOffered": {
"@type": "HotelRoom",
"name": "YOUR_ROOM_TYPE_1"
}
},
{
"@type": "Offer",
"name": "YOUR_ROOM_TYPE_2",
"description": "YOUR_ROOM_DESCRIPTION_2",
"price": "YOUR_NIGHTLY_RATE_2",
"priceCurrency": "USD",
"unitCode": "DAY",
"availability": "https://schema.org/InStock",
"itemOffered": {
"@type": "HotelRoom",
"name": "YOUR_ROOM_TYPE_2"
}
}
],
"potentialAction": {
"@type": "ReserveAction",
"target": {
"@type": "EntryPoint",
"urlTemplate": "https://YOUR_DOMAIN.com/booking/",
"actionPlatform": [
"https://schema.org/DesktopWebPlatform",
"https://schema.org/MobileWebPlatform"
]
},
"name": "Book a Room"
}
},
{
"@type": "WebPage",
"@id": "https://YOUR_DOMAIN.com/booking/#webpage",
"url": "https://YOUR_DOMAIN.com/booking/",
"name": "Book a Room — YOUR_PROPERTY_NAME",
"isPartOf": {
"@id": "https://YOUR_DOMAIN.com/#website"
},
"about": {
"@id": "https://YOUR_DOMAIN.com/#property"
}
},
{
"@type": "BreadcrumbList",
"@id": "https://YOUR_DOMAIN.com/booking/#breadcrumb",
"itemListElement": [
{
"@type": "ListItem",
"position": 1,
"name": "Home",
"item": "https://YOUR_DOMAIN.com/"
},
{
"@type": "ListItem",
"position": 2,
"name": "Book a Room",
"item": "https://YOUR_DOMAIN.com/booking/"
}
]
},
{
"@type": "FAQPage",
"mainEntity": [
{
"@type": "Question",
"name": "YOUR_FAQ_QUESTION_1",
"acceptedAnswer": {
"@type": "Answer",
"text": "YOUR_FAQ_ANSWER_1"
}
},
{
"@type": "Question",
"name": "YOUR_FAQ_QUESTION_2",
"acceptedAnswer": {
"@type": "Answer",
"text": "YOUR_FAQ_ANSWER_2"
}
},
{
"@type": "Question",
"name": "YOUR_FAQ_QUESTION_3",
"acceptedAnswer": {
"@type": "Answer",
"text": "YOUR_FAQ_ANSWER_3"
}
}
]
}
]
}
Use ReserveAction as a potentialAction on the booking page. LodgingReservation is for confirmed reservations (like booking confirmations), not for the booking page itself. The action tells AI "this is where you can book," while the reservation describes "this is a booking that was made."
If your booking page redirects to a third-party system, use that URL in the urlTemplate of the EntryPoint. The structured data should point to wherever the traveler actually completes the booking, even if it is hosted by a different domain.
Include all bookable room types. Each Offer gives AI another option to match against traveler queries. If someone asks for "a suite with a king bed under $200," AI can only match that query if your suite is listed with its bed type and price.