Single Family Residence Sale Schema Markup (JSON-LD)
Models residential single-family homes for sale including room counts, living area square footage, postal address, listing broker, and pricing offers for real estate search engines.
Displayed below main page header or above the tool container. • Zero CLS Container
Production JSON-LD Code Block
Embed this structured data block directly into your HTML <head> or framework layout template.
{
"@context": "https://schema.org",
"@type": "SingleFamilyResidence",
"@id": "https://example.com/listings/124-maple-drive#residence",
"name": "124 Maple Drive Modern Colonial",
"description": "Newly renovated 4-bedroom single-family colonial residence with finished basement and two-car attached garage.",
"numberOfRooms": 9,
"numberOfBedrooms": 4,
"numberOfBathroomsTotal": 3.5,
"floorSize": {
"@type": "QuantitativeValue",
"value": 3250,
"unitCode": "FTK"
},
"yearBuilt": 2018,
"address": {
"@type": "PostalAddress",
"streetAddress": "124 Maple Drive",
"addressLocality": "Austin",
"addressRegion": "TX",
"postalCode": "78701",
"addressCountry": "US"
},
"geo": {
"@type": "GeoCoordinates",
"latitude": 30.2672,
"longitude": -97.7431
},
"offers": {
"@type": "Offer",
"price": "875000",
"priceCurrency": "USD",
"availability": "https://schema.org/InStock",
"validFrom": "2026-10-01",
"businessFunction": "http://purl.org/goodrelations/v1#Sell"
}
}Typed Properties Specification (8 Fields)
Key Schema.org properties and sub-objects required to qualify for rich snippet treatment in Google Search.
| Property | Expected Type | Status | Description & Example |
|---|---|---|---|
| numberOfRooms | Integer | Required | Total count of interior rooms excluding bathrooms and unconditioned utility areas. e.g. 9 |
| numberOfBedrooms | Integer | Required | Number of designated residential sleeping bedrooms. e.g. 4 |
| numberOfBathroomsTotal | Number | Required | Total number of full and partial bathrooms in the residence. e.g. 3.5 |
| floorSize | QuantitativeValue | Required | Gross conditioned living floor area with standardized UN/CEFACT unitCode (e.g., FTK for sq ft, MTK for sq m). e.g. { "@type": "QuantitativeValue", "value": 3250, "unitCode": "FTK" } |
| address | PostalAddress | Required | Physical street address and postal location of the real estate parcel. e.g. { "@type": "PostalAddress", "streetAddress": "124 Maple Drive", ... } |
| offers | Offer | Required | Real estate listing price, transaction currency, availability state, and listing duration. e.g. { "@type": "Offer", "price": "875000", "priceCurrency": "USD" } |
| yearBuilt | Integer | Recommended | The calendar year in which residential property construction was completed. e.g. 2018 |
| geo | GeoCoordinates | Recommended | Precise latitude and longitude coordinates for map pinning and spatial queries. e.g. { "@type": "GeoCoordinates", "latitude": 30.2672, "longitude": -97.7431 } |
Google Search Console Pitfalls & Critical Warnings
Avoid these 3 common validation traps, parser errors, and algorithmic policy penalties when deploying SingleFamilyResidence schema.
Missing UN/CEFACT UnitCode in FloorSize
Specifying a naked numeric value for floorSize without a quantitative unitCode causes search crawlers to misinterpret square feet as square meters.
Use a QuantitativeValue node with unitCode 'FTK' (square feet) or 'MTK' (square meters).
Omission of BusinessFunction Sell on Property Offers
Failing to disambiguate whether an offer represents a property purchase sale vs monthly lease confused housing search engines.
Explicitly set businessFunction to 'http://purl.org/goodrelations/v1#Sell' on sales listings.
Stale Pending/Sold Status in Offers Availability
Keeping 'InStock' availability after a contract closes violates Google Search accuracy policies for commercial listings.
Automate real-time MLS sync to update availability to 'Discontinued' or 'OutOfStock' once under escrow.
Recommended Implementation Scenarios
Related Schema Blueprints
Explore complementary structured data blueprints across the Local Business cluster.
Real Estate Listing & Broker Offer Schema Markup (JSON-LD)
Residential Condominium Unit Schema Markup (JSON-LD)
Luxury Estate & Penthouse Schema Markup (JSON-LD)
Apartment Rental Complex Schema Markup (JSON-LD)
Displayed below main page header or above the tool container. • Zero CLS Container