Real estate schema markup won't push your listings to the top of Google but it will help reduce ambiguity. In this guide we will explore everything you need to know about schema, the types to use and ways to implement it on your website.
Schema markup does not replace good content, strong backlinks, technical SEO.
It is also not a silver bullet either. Adding it to your website doesn’t guarantee stronger rankings or more organic traffic but it is another lever you have at your disposal to improve your SEO efforts.
Not sure where schema fits into your website’s SEO priorities? Get a free real estate SEO audit to find out what to fix first.
Schema markup is structured data code written in JSON-LD that you add to either the head or opening body of a webpage on your website to help search engines reduce ambiguity about your content.
There are several vocabularies that you can use, including your own, but the most widely used and accepted version is schema.org
Schema markup is the code you add to your website, while rich results are what appears in search results when that code works properly.
Schema markup doesn't guarantee rich results, but it makes them possible.
The main point of schema markup is to remove ambiguity by building relationships between different entities/topics and providing information in a key value pair that is easy to understand.
It can be argued that reducing ambiguity can improve content relevance which can improve rankings but again its not a guarantee.
JSON-LD is JavaScript Object Notation for Linked Data, and it's the format Google explicitly recommends for structured data implementation.
The primary advantage is separation of concerns. JSON-LD sits in a script tag in your page's head section, completely separate from your visible HTML content.
This means you can add, edit, or remove schema markup without touching your page design or risking breaking your layout.
Microdata embeds schema markup directly into your HTML tags using attributes like itemscope, itemtype, and itemprop. Instead of separate structured data code, you're adding attributes to the HTML elements that display your content.
Here's what that looks like for a simple property address:
HTML
<div itemscope itemtype="https://schema.org/RealEstateListing">
<span itemprop="name">Beautiful Home in Arlington Heights</span>
<div itemprop="address" itemscope itemtype="https://schema.org/PostalAddress">
<span itemprop="streetAddress">123 Main Street</span>
<span itemprop="addressLocality">Arlington Heights</span>
<span itemprop="addressRegion">IL</span>
</div>
</div>I wouldn’t recommend using this type as it will add to the technical overhead and maintenance of your site.
RDFa is Resource Description Framework in Attributes, another method of embedding structured data directly into HTML. It's similar to Microdata but uses different attribute names like vocab, typeof, and property.
Here's the same property address in RDFa:
HTML
<div vocab="https://schema.org/" typeof="RealEstateListing">
<span property="name">Beautiful Home in Arlington Heights</span>
<div property="address" typeof="PostalAddress">
<span property="streetAddress">123 Main Street</span>
<span property="addressLocality">Arlington Heights</span>
<span property="addressRegion">IL</span>
</div>
</div>RDFa offers more flexibility than Microdata for complex semantic relationships and was originally developed for the semantic web. Some content management systems favor RDFa because it integrates with their existing infrastructure.
For real estate websites specifically, RDFa has limited advantages over JSON-LD and shares Microdata's maintenance challenges.
The RealEstateListing schema is specifically designed for real estate listings as it contains the same details you would find in the MLS.
When you draft your markup ensure you always include these properties:
JSON-LD Code Example:
JSON
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "RealEstateListing",
"name": "Beautiful 3-Bedroom Home in Arlington Heights",
"url": "https://www.yourwebsite.com/listings/123-main-street",
"description": "Stunning renovated home with modern kitchen, hardwood floors, and large backyard perfect for entertaining.",
"datePosted": "2024-11-15",
"validThrough": "2025-05-15",
"address": {
"@type": "PostalAddress",
"streetAddress": "123 Main Street",
"addressLocality": "Arlington Heights",
"addressRegion": "IL",
"postalCode": "60004",
"addressCountry": "US"
},
"price": "450000",
"priceCurrency": "USD",
"availableAtOrFrom": {
"@type": "Place",
"address": {
"@type": "PostalAddress",
"streetAddress": "123 Main Street",
"addressLocality": "Arlington Heights",
"addressRegion": "IL",
"postalCode": "60004"
}
}
}
</script>While RealEstateListing tells search engines it's a property for sale, SingleFamilyResidence tells them what type of property it is.
This schema includes detailed specifications unique to single-family homes, number of bedrooms and bathrooms, parking capacity, property size, and lot dimensions.
Again the main benefit is a lot of this information is found in the MLS so you don’t need to go out of your way to write every listing by hand.
JSON-LD Code Example:
JSON
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "SingleFamilyResidence",
"name": "Beautiful 3-Bedroom Home in Arlington Heights",
"address": {
"@type": "PostalAddress",
"streetAddress": "123 Main Street",
"addressLocality": "Arlington Heights",
"addressRegion": "IL",
"postalCode": "60004",
"addressCountry": "US"
},
"numberOfRooms": 8,
"numberOfBedrooms": 3,
"numberOfBathroomsTotal": 2,
"floorSize": {
"@type": "QuantitativeValue",
"value": 2100,
"unitCode": "FTK"
},
"yearBuilt": 1985,
"numberOfParkingSpaces": 2,
"amenityFeature": [
{
"@type": "LocationFeatureSpecification",
"name": "Hardwood Floors",
"value": true
},
{
"@type": "LocationFeatureSpecification",
"name": "Central Air Conditioning",
"value": true
},
{
"@type": "LocationFeatureSpecification",
"name": "Fireplace",
"value": true
}
]
}
</script>The Apartment schema serves the same purpose as SingleFamilyResidence but for multi-unit dwellings. It includes properties specific to apartment living, floor level, pet policies, amenities, and lease terms.
Include unit-specific details like
JSON-LD Code Example:
JSON
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "Apartment",
"name": "Modern 2-Bedroom Apartment - Unit 304",
"address": {
"@type": "PostalAddress",
"streetAddress": "456 Park Avenue, Unit 304",
"addressLocality": "Chicago",
"addressRegion": "IL",
"postalCode": "60611",
"addressCountry": "US"
},
"numberOfRooms": 5,
"numberOfBedrooms": 2,
"numberOfBathroomsTotal": 2,
"floorSize": {
"@type": "QuantitativeValue",
"value": 1200,
"unitCode": "FTK"
},
"floorLevel": "3",
"occupancy": {
"@type": "QuantitativeValue",
"maxValue": 4
},
"petsAllowed": "Dogs and cats under 25 lbs allowed",
"amenityFeature": [
{
"@type": "LocationFeatureSpecification",
"name": "In-Unit Washer/Dryer",
"value": true
},
{
"@type": "LocationFeatureSpecification",
"name": "Balcony",
"value": true
},
{
"@type": "LocationFeatureSpecification",
"name": "Stainless Steel Appliances",
"value": true
}
],
"leaseLength": {
"@type": "QuantitativeValue",
"value": 12,
"unitCode": "MON"
}
}
</script>ApartmentComplex schema marks up entire multi-unit properties rather than individual units.
This schema includes properties like total number of units, available amenities, contact information, and general pricing ranges.
Use this schema onlanding pages for apartment buildings or complexes. It's perfect for property management companies managing multiple units within a single location.
The key distinction here is scale.
While individual Apartment schemas handle unit-specific details, ApartmentComplex communicates building-wide information, pool facilities, parking structures, pet policies, and community amenities that apply across all units.
JSON-LD Code Example:
JSON
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "ApartmentComplex",
"name": "Lakeside Towers Apartments",
"address": {
"@type": "PostalAddress",
"streetAddress": "456 Park Avenue",
"addressLocality": "Chicago",
"addressRegion": "IL",
"postalCode": "60611",
"addressCountry": "US"
},
"telephone": "+1-312-555-0199",
"email": "leasing@lakesidetowers.com",
"url": "https://www.lakesidetowers.com",
"numberOfAccommodationUnits": 150,
"petsAllowed": "Dogs and cats under 25 lbs allowed with deposit",
"amenityFeature": [
{
"@type": "LocationFeatureSpecification",
"name": "Fitness Center",
"value": true
},
{
"@type": "LocationFeatureSpecification",
"name": "Rooftop Pool",
"value": true
},
{
"@type": "LocationFeatureSpecification",
"name": "24-Hour Concierge",
"value": true
},
{
"@type": "LocationFeatureSpecification",
"name": "Parking Garage",
"value": true
},
{
"@type": "LocationFeatureSpecification",
"name": "Business Center",
"value": true
}
],
"geo": {
"@type": "GeoCoordinates",
"latitude": "41.8919",
"longitude": "-87.6270"
}
}
</script>The RealEstateAgent schema puts your professional profile into search engines' structured data.
This schema includes your name, credentials, license information, areas served, and specializations.
This is a very effective strategy for local SEO as it directly communicates your service area which sends location signals to search engines.
JSON-LD Code Example:
JSON
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "RealEstateAgent",
"name": "Sarah Mitchell",
"url": "https://www.yourwebsite.com/agents/sarah-mitchell",
"image": "https://www.yourwebsite.com/images/sarah-mitchell.jpg",
"telephone": "+1-847-555-0123",
"email": "sarah@yourwebsite.com",
"address": {
"@type": "PostalAddress",
"streetAddress": "789 Business Plaza, Suite 200",
"addressLocality": "Arlington Heights",
"addressRegion": "IL",
"postalCode": "60005",
"addressCountry": "US"
},
"areaServed": [
{
"@type": "City",
"name": "Arlington Heights"
},
{
"@type": "City",
"name": "Palatine"
},
{
"@type": "City",
"name": "Mount Prospect"
}
],
"knowsLanguage": ["English", "Spanish"],
"memberOf": {
"@type": "Organization",
"name": "National Association of Realtors"
}
}
</script>Event schema is designed for open houses, property tours, first-time homebuyer seminars, and any real estate-related events you host.
It includes start and end times, location details, registration information, and event descriptions.
JSON-LD Code Example:
JSON
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "Event",
"name": "Open House - 123 Main Street",
"description": "Join us for an open house at this beautiful 3-bedroom home in Arlington Heights. Tour the property, ask questions, and learn about the neighborhood.",
"startDate": "2024-12-14T13:00:00-06:00",
"endDate": "2024-12-14T15:00:00-06:00",
"eventStatus": "https://schema.org/EventScheduled",
"eventAttendanceMode": "https://schema.org/OfflineEventAttendanceMode",
"location": {
"@type": "Place",
"name": "123 Main Street",
"address": {
"@type": "PostalAddress",
"streetAddress": "123 Main Street",
"addressLocality": "Arlington Heights",
"addressRegion": "IL",
"postalCode": "60004",
"addressCountry": "US"
}
},
"image": "https://www.yourwebsite.com/listings/123-main-street/photos/front.jpg",
"organizer": {
"@type": "RealEstateAgent",
"name": "Sarah Mitchell",
"telephone": "+1-847-555-0123",
"email": "sarah@yourwebsite.com",
"url": "https://www.yourwebsite.com/agents/sarah-mitchell"
},
"offers": {
"@type": "Offer",
"url": "https://www.yourwebsite.com/listings/123-main-street",
"price": "0",
"priceCurrency": "USD",
"availability": "https://schema.org/InStock",
"validFrom": "2024-11-15T00:00:00-06:00"
}
}
</script>FAQPage schema structures your frequently asked questions so they can appear as rich results directly in search.
Use FAQPage schema on property detail pages with common questions, neighborhood guides with local FAQs, and dedicated FAQ sections addressing buyer or seller concerns.
Include questions about property specifics, neighborhood details, buying processes, and financing options relevant to your listings.
JSON-LD Code Example:
JSON
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "FAQPage",
"mainEntity": [
{
"@type": "Question",
"name": "What is included in the sale of 123 Main Street?",
"acceptedAnswer": {
"@type": "Answer",
"text": "The sale includes all kitchen appliances (refrigerator, dishwasher, range, and microwave), washer and dryer, window treatments throughout, the shed in the backyard, and all lighting fixtures. The home also comes with a one-year home warranty for added peace of mind."
}
},
{
"@type": "Question",
"name": "What are the property taxes for this home?",
"acceptedAnswer": {
"@type": "Answer",
"text": "The current annual property taxes are approximately $8,200. This is based on the most recent tax year. Property taxes in Arlington Heights are subject to change based on assessments and local tax rates."
}
},
{
"@type": "Question",
"name": "What school district is this property in?",
"acceptedAnswer": {
"@type": "Answer",
"text": "This home is located in Arlington Heights School District 25 for elementary and middle school, and Township High School District 214 for high school. The assigned schools are Thomas Middle School and Hersey High School, both of which have excellent ratings."
}
},
{
"@type": "Question",
"name": "Is the basement finished?",
"acceptedAnswer": {
"@type": "Answer",
"text": "Yes, the basement is fully finished with a family room, full bathroom, and additional bedroom. The basement also includes a utility room with the furnace, water heater, and plenty of storage space."
}
}
]
}
</script>BlogPosting schema tells search engines exactly what each article is about, who wrote it, when it was published, and what topics it covers.
Implement BlogPosting schema on every article in your real estate blog, market updates, neighborhood guides, home buying tips, and property spotlights.
Start by choosing long tail keywords that reflect specific local searches, then use BlogPosting schema to describe the articles you create around them.
This schema includes properties like headline, author, publication date, featured image, and article body.
JSON-LD Code Example:
JSON
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "BlogPosting",
"headline": "Arlington Heights Real Estate Market Update - December 2024",
"alternativeHeadline": "What Buyers and Sellers Need to Know About Arlington Heights Home Prices",
"image": "https://www.yourwebsite.com/blog/images/arlington-market-dec-2024.jpg",
"author": {
"@type": "Person",
"name": "Sarah Mitchell",
"url": "https://www.yourwebsite.com/agents/sarah-mitchell"
},
"publisher": {
"@type": "Organization",
"name": "Premier Realty Group",
"logo": {
"@type": "ImageObject",
"url": "https://www.premierrealtygroup.com/images/logo.png"
}
},
"datePublished": "2024-12-04",
"dateModified": "2024-12-04",
"description": "Comprehensive analysis of the Arlington Heights real estate market including median home prices, inventory levels, days on market, and predictions for 2025.",
"articleBody": "The Arlington Heights real estate market continues to show resilience...",
"url": "https://www.yourwebsite.com/blog/arlington-heights-market-update-december-2024",
"mainEntityOfPage": {
"@type": "WebPage",
"@id": "https://www.yourwebsite.com/blog/arlington-heights-market-update-december-2024"
},
"keywords": [
"Arlington Heights real estate",
"home prices Arlington Heights",
"real estate market update",
"buying a home Arlington Heights"
]
}
</script>Video schema marks up your virtual tours, property walkthroughs, and real estate educational content.
Use it on property pages with virtual tours, YouTube embeds on your website, and dedicated video gallery pages. Include properties like video name, description, thumbnail URL, upload date, and content URL.
JSON-LD Code Example:
JSON
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "VideoObject",
"name": "Virtual Tour - 123 Main Street, Arlington Heights",
"description": "Take a complete virtual tour of this stunning 3-bedroom home in Arlington Heights featuring hardwood floors, renovated kitchen, and beautiful backyard. See every room and all the amazing features this property has to offer.",
"thumbnailUrl": "https://www.yourwebsite.com/listings/123-main-street/video-thumbnail.jpg",
"uploadDate": "2024-11-20T08:00:00-06:00",
"duration": "PT3M45S",
"contentUrl": "https://www.yourwebsite.com/videos/123-main-street-tour.mp4",
"embedUrl": "https://www.youtube.com/embed/abc123xyz",
"publisher": {
"@type": "Organization",
"name": "Premier Realty Group",
"logo": {
"@type": "ImageObject",
"url": "https://www.premierrealtygroup.com/images/logo.png"
}
},
"potentialAction": {
"@type": "SeekToAction",
"target": "https://www.yourwebsite.com/videos/123-main-street-tour.mp4?t={seek_to_second_number}",
"startOffset-input": "required name=seek_to_second_number"
}
}
</script>ChatGPT, Claude, Gemini, Grok and Cursor can now write JSON-LD very well if you mention to use the schema.org vocabularity.
This is probably your best choice as you can fully leverage the MLS to add every field that you want.
The best part is that real estate listings change every day so all this data gets updated dynamically so you really can set it and forget it.
If you have a WordPress website some plugins like Yoast or Rank Math automatically add schema / give you some control over schema implementation.
This is great for a quick implementation but is often the most basic.
Just google “real estate schema markup generators” and I can guarantee you will find some free generators that can do the job.
It requires a lot of manual entry so this is really the worst option.
I genuinely don’t see a use case for this.
The Schema.org validator is your first line of defense.
This official tool checks whether your schema markup follows the Schema.org specification, proper syntax, valid property names, correct nesting structure, and appropriate property types.
Google's Rich Results Test serves a different purpose than general schema validation. This tool specifically checks whether your schema markup qualifies for rich results in Google Search.
Run your property page URLs through this validator to see both the structured data Google detects and whether that data meets rich result requirements.
Schema validation is only one part of checking your website. Find and fix the technical SEO issues holding your website back, including IDX duplicate content, crawl problems, and slow pages.
Classy Schema offers more detailed error reporting and additional insights beyond basic syntax validation.
This third-party validator provides clearer explanations of errors, context-aware suggestions for fixes, and warnings about properties that could be improved even when not technically errors.
It catches edge cases that other validators miss and provides the clearest explanations for fixing complex errors.
As I mentioned before, schema markup is not a silver bullet. It has its use but it will not increase your rankings automatically.
However, most real estate websites lack it, giving you a strong competitive advantage.
Book a free SEO audit today to learn other strategies that can improve your organic visibility.
Related articles
Keep reading in the same category to go deeper on the topics that matter to your team.
Answer engine optimization explained for real estate: how AI answers pick their sources, what to publish, what to measure, and the fair housing line to stay behind.
GEO vs SEO vs AEO explained for real estate agents: which searches each one wins, what changes in your content, and where a solo agent should start.
Generative engine optimization for real estate teams: how to get cited by ChatGPT, Gemini and AI Overviews, with a checklist and the data behind it.
About Madison
Madison is Realty AI's conversational assistant for real estate websites. It engages visitors instantly, qualifies buyers, sellers, and renters through natural dialogue, routes summaries to your CRM, and keeps your team focused on closing.
5.0 average from 2,500 customer reviews
Sarah Logue
Broker & Owner, Top 0.1%
Mark Jensen
Owner & Broker of Record
Michelle Makos
Broker & Owner
See it in action
See how Madison qualifies, books, and routes leads in 2 seconds, across every page on your site.
