Residence

Residence is a Place subtype for a residential building: a single-family house as a location, an apartment complex, a condo building, a gated community. Note: Residence is about the place, not the housing unit; for an individual unit, use Apartment or similar Accommodation subtypes.

Residence adds 2 properties: accommodationFloorPlan (a FloorPlan for the whole building) and floorLevel (Text, for multi-story building addresses). Direct subtypes are ApartmentComplex and GatedResidenceCommunity.

Full example of schema.org/Residence json-ld markup

The markup is verified as valid with Rich Results Test from Google.

schema.org/Residence

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Residence",
  "name": "The Riverfront Residences",
  "address": {
    "@type": "PostalAddress",
    "streetAddress": "14 Riverfront Pl",
    "addressLocality": "Dunmore",
    "addressRegion": "PA",
    "postalCode": "18512",
    "addressCountry": "US"
  },
  "description": "Six-story residential building in downtown Dunmore with 48 apartments, rooftop terrace, and ground-floor retail.",
  "accommodationFloorPlan": { "@type": "FloorPlan", "name": "Standard two-bedroom layout", "numberOfRooms": 4, "numberOfBedrooms": 2, "numberOfBathroomsTotal": 2 }
}
</script>

Residence vs Accommodation

Residence is the Place (the building at an address). Accommodation is the space for rent/sale (the apartment, the room). An ApartmentComplex (Residence) holds many Apartment (Accommodation) units; the two link via containsPlace or by keeping the Apartment's address and the ApartmentComplex's address consistent.

Minimal valid version

The smallest markup that still produces a valid Residence entity. Use it as the floor. Reach for the advanced example above when you want search engines and AI agents to understand more about your content.

schema.org/Residence (minimal)

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Residence",
  "name": "The Riverfront Residences",
  "address": { "@type": "PostalAddress", "streetAddress": "14 Riverfront Pl", "addressLocality": "Dunmore", "addressRegion": "PA", "postalCode": "18512", "addressCountry": "US" }
}
</script>

Google rich results this unlocks

Residence is a structural type. It does not produce a rich result on its own.

Its value comes from combining it with a primary type whose markup earns a rich result (Article, Product, Event, and so on). Residence becomes the trunk that the primary type branches off viamainEntityorbreadcrumb. Include it on every page as the backbone of your markup.

Common Residence mistakes

Mistakes that pass validation but silently fail to earn rich results or mislead consumers walking the graph. Avoid these and your markup will be ahead of most sites in the wild.

01
Using Residence for a rental listing
Wrong
```
Residence for a specific apartment for rent
```
Right
```
Apartment (Accommodation subtype) for the unit; Residence for the building
```
A rental listing is about the unit, not the whole building. Real-estate search APIs index Accommodation subtypes, not Residence.

Schema properties in this example

Residence Place name address PostalAddress streetAddress addressLocality addressRegion postalCode addressCountry description accommodationFloorPlan FloorPlan numberOfRooms numberOfBedrooms numberOfBathroomsTotal floorLevel ApartmentComplex GatedResidenceCommunity

About the example data

A fictional Xoo Code Homes apartment building in downtown Dunmore, PA.

Comments

Loading comments...