Organizations Local Business LodgingBusiness

Rooms Page Blueprint — Lodging Business

The rooms page is where AI systems learn what accommodations you offer. Structured room data lets AI match travelers to the right room type based on party size, budget, and preferences. This blueprint gives you the complete JSON-LD graph for machine-readable room listings.

What this page needs

A rooms page without structured data forces AI to guess about your accommodations. With proper HotelRoom markup, AI can parse your room types, bed configurations, occupancy limits, and nightly rates — making your property far more useful in travel queries.

Why these fields matter to AI

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

LodgingBusiness

name
Non-negotiable. AI cannot cite or recommend an unnamed entity.
url
AI needs a stable URL to route users and attribute recommendations.

Use This Prompt to Implement Your Schema

Copy 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.

Implementation Prompt · Rooms
You are implementing AIFDS-compliant JSON-LD structured data for a Lodging Business Rooms 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. Bed count
2. Bed type
3. Domain
4. Faq answer
5. Faq question
6. Max guests
7. Nightly rate
8. Property name
9. Room amenity
10. Room description
11. Room image
12. 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 Rooms"
- 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

Template — fill in your values

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 rooms page.

JSON-LD · Rooms
{
  "@context": "https://schema.org",
  "@graph": [
    {
      "@type": "LodgingBusiness",
      "@id": "https://YOUR_DOMAIN.com/#property",
      "name": "YOUR_PROPERTY_NAME",
      "url": "https://YOUR_DOMAIN.com",
      "containsPlace": [
        {
          "@type": "HotelRoom",
          "name": "YOUR_ROOM_TYPE_1",
          "description": "YOUR_ROOM_DESCRIPTION_1",
          "image": "https://YOUR_DOMAIN.com/YOUR_ROOM_IMAGE_1.jpg",
          "bed": {
            "@type": "BedDetails",
            "typeOfBed": "YOUR_BED_TYPE_1",
            "numberOfBeds": "YOUR_BED_COUNT_1"
          },
          "occupancy": {
            "@type": "QuantitativeValue",
            "maxValue": "YOUR_MAX_GUESTS_1"
          },
          "amenityFeature": [
            {
              "@type": "LocationFeatureSpecification",
              "name": "YOUR_ROOM_AMENITY_1",
              "value": true
            }
          ],
          "offers": {
            "@type": "Offer",
            "price": "YOUR_NIGHTLY_RATE_1",
            "priceCurrency": "USD",
            "unitCode": "DAY"
          }
        },
        {
          "@type": "HotelRoom",
          "name": "YOUR_ROOM_TYPE_2",
          "description": "YOUR_ROOM_DESCRIPTION_2",
          "image": "https://YOUR_DOMAIN.com/YOUR_ROOM_IMAGE_2.jpg",
          "bed": {
            "@type": "BedDetails",
            "typeOfBed": "YOUR_BED_TYPE_2",
            "numberOfBeds": "YOUR_BED_COUNT_2"
          },
          "occupancy": {
            "@type": "QuantitativeValue",
            "maxValue": "YOUR_MAX_GUESTS_2"
          },
          "offers": {
            "@type": "Offer",
            "price": "YOUR_NIGHTLY_RATE_2",
            "priceCurrency": "USD",
            "unitCode": "DAY"
          }
        }
      ]
    },
    {
      "@type": "WebPage",
      "@id": "https://YOUR_DOMAIN.com/rooms/#webpage",
      "url": "https://YOUR_DOMAIN.com/rooms/",
      "name": "Rooms — YOUR_PROPERTY_NAME",
      "isPartOf": {
        "@id": "https://YOUR_DOMAIN.com/#website"
      },
      "about": {
        "@id": "https://YOUR_DOMAIN.com/#property"
      }
    },
    {
      "@type": "BreadcrumbList",
      "@id": "https://YOUR_DOMAIN.com/rooms/#breadcrumb",
      "itemListElement": [
        {
          "@type": "ListItem",
          "position": 1,
          "name": "Home",
          "item": "https://YOUR_DOMAIN.com/"
        },
        {
          "@type": "ListItem",
          "position": 2,
          "name": "Rooms",
          "item": "https://YOUR_DOMAIN.com/rooms/"
        }
      ]
    },
    {
      "@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"
          }
        }
      ]
    }
  ]
}

Frequently asked questions

Should I list every room individually or just room types?

List room types, not individual rooms. AI needs to understand your categories — "King Suite," "Double Queen," "Standard Single" — not that you have 40 identical rooms. Each HotelRoom node represents a type of accommodation you offer.

How should I handle seasonal pricing?

Use your base or most common rate in the price field. If rates vary significantly by season, you can add validFrom and validThrough on each Offer to specify date ranges. Keep the data current — stale pricing in structured data damages trust.

What bed types should I use in the schema?

Use common, descriptive names: "King," "Queen," "Double," "Twin," "Sofa Bed," "Bunk Bed." These match the terms travelers use in queries. AI can then match requests like "room with a king bed" directly to your room types.

Test your structured data

Paste your URL and see exactly what AI systems can read from your site.

Open Validator →