XooCode(){

ApartmentComplex

ApartmentComplex is a Residence subtype for a residential community: a garden-apartment complex, a high-rise condo building, a student-housing village. It adds 5 properties: numberOfAccommodationUnits, numberOfAvailableAccommodationUnits, numberOfBedrooms (range across unit types), petsAllowed, and tourBookingPage (URL for scheduling a tour).

Individual units are Apartment. Link the complex to its FloorPlan entries via accommodationFloorPlan (inherited from Residence), and to specific units via containsPlace.

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

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

schema.org/ApartmentComplex
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "ApartmentComplex",
  "name": "The Riverfront Residences",
  "address": {
    "@type": "PostalAddress",
    "streetAddress": "14 Riverfront Pl",
    "addressLocality": "Dunmore",
    "addressRegion": "PA",
    "postalCode": "18512",
    "addressCountry": "US"
  },
  "numberOfAccommodationUnits": { "@type": "QuantitativeValue", "value": 48 },
  "numberOfAvailableAccommodationUnits": { "@type": "QuantitativeValue", "value": 4 },
  "petsAllowed": true,
  "tourBookingPage": "https://xoocode.com/homes/riverfront/book-a-tour",
  "accommodationFloorPlan": [
    { "@type": "FloorPlan", "name": "Standard 1BR", "numberOfBedrooms": 1 },
    { "@type": "FloorPlan", "name": "Standard 2BR", "numberOfBedrooms": 2 },
    { "@type": "FloorPlan", "name": "Penthouse 3BR", "numberOfBedrooms": 3 }
  ]
}
</script>

Minimal valid version

The smallest markup that still produces a valid ApartmentComplex 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/ApartmentComplex (minimal)
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "ApartmentComplex",
  "name": "The Riverfront Residences",
  "numberOfAccommodationUnits": { "@type": "QuantitativeValue", "value": 48 }
}
</script>

Google rich results this unlocks

ApartmentComplex 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). ApartmentComplex becomes the trunk that the primary type branches off viamainEntityorbreadcrumb. Include it on every page as the backbone of your markup.

Common ApartmentComplex 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.

  1. 01

    Using ApartmentComplex for a single unit listing

    Wrong
    ApartmentComplex on a page that lists one apartment for rent
    Right
    Apartment for a single unit listing; ApartmentComplex only for the whole building

    Real-estate listing aggregators index Apartment for rental search. ApartmentComplex is the building-level entity.

Schema properties in this example

ApartmentComplexResidencePlacenameaddressPostalAddressstreetAddressaddressLocalityaddressRegionpostalCodeaddressCountrynumberOfAccommodationUnitsQuantitativeValuevaluenumberOfAvailableAccommodationUnitspetsAllowedtourBookingPageaccommodationFloorPlanFloorPlannumberOfBedroomsApartment

About the example data

The Riverfront Residences in Dunmore, a 48-unit apartment complex with three floor-plan options.

Comments

Loading comments...

Leave a comment