leaseLength

leaseLength · Not mentioned by Google

Appears in

• RealEstateListing

What is it?

leaseLength specifies how long a lease runs for a property listing. It distinguishes a 6-month sublet from a 12-month standard lease or a 3-year commercial agreement. The value can be an ISO 8601 duration string (like "P12M" for 12 months) or a QuantitativeValue object with a number and unit.

Why this matters for AEO

When someone asks an AI engine "Find apartments in Chicago with a 6-month lease," the AI needs structured lease duration data to filter results. leaseLength provides that filter directly. Without it, AI systems must parse listing descriptions for phrases like "6-month lease available," which is unreliable and inconsistent across listing sites.

What the specs say

Schema.org: Duration or QuantitativeValue. Length of the lease for some Accommodation, either particular to some Offer or in some cases intrinsic to the property. schema.org/leaseLength

Google: Not mentioned. No dedicated Google structured data page exists for the RealEstateListing type.

How to find your value

• Lease agreement — The term length clause in the rental contract
• Property listing — The lease duration stated in the listing details
• Property manager — Ask the landlord or management company for the standard lease term
• Common values — 6 months, 12 months, 24 months, month-to-month

Format and code

leaseLength accepts either an ISO 8601 Duration string or a QuantitativeValue object. The QuantitativeValue pattern is more common in practice.

QuantitativeValue (recommended)

{
  "@context": "https://schema.org",
  "@type": "RealEstateListing",
  "name": "Modern 2-Bedroom Apartment",
  "url": "https://example.com/listings/apt-304",
  "leaseLength": {
    "@type": "QuantitativeValue",
    "value": 12,
    "unitText": "months"
  }
}

ISO 8601 Duration

{
  "@context": "https://schema.org",
  "@type": "RealEstateListing",
  "name": "Studio Apartment Downtown",
  "leaseLength": "P12M"
}

Common duration values: P6M (6 months), P12M (12 months), P24M (24 months), P1Y (1 year).

On an Accommodation type

leaseLength also applies to Accommodation and Offer types:

{
  "@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"
  },
  "numberOfBedrooms": 2,
  "leaseLength": {
    "@type": "QuantitativeValue",
    "value": 12,
    "unitText": "months"
  }
}

Webflow implementation

Static pages

Add JSON-LD in Page Settings > Custom Code (before </head>):

{
  "@context": "https://schema.org",
  "@type": "RealEstateListing",
  "name": "Your Property Listing",
  "leaseLength": {
    "@type": "QuantitativeValue",
    "value": 12,
    "unitText": "months"
  }
}

CMS template pages

For real estate sites built on Webflow CMS, create a number field for lease duration and a plain text field for the unit (months/years). Reference both in the JSON-LD embed to build the QuantitativeValue object dynamically per listing.

In Schema HQ

The leaseLength field configures leaselength as a quantitativevalue when the lease term is configured in the property listing schema. enter the numeric duration and unit, and schema hq handles the json-ld output.

Real examples

VGAN Choice uses leaseLength with a QuantitativeValue object on a RealEstateListing:

{
  "@type": "RealEstateListing",
  "name": "VGAN Super Property",
  "datePosted": "2022-12-19T11:33:41+01:00",
  "leaseLength": {
    "@type": "QuantitativeValue",
    "value": 6,
    "unitText": "months"
  }
}

Source: metamanager.io

Realty AI demonstrates leaseLength on an Apartment type with full address markup:

{
  "@type": "Apartment",
  "name": "Modern 2-Bedroom Apartment - Unit 304",
  "numberOfBedrooms": 2,
  "leaseLength": {
    "@type": "QuantitativeValue",
    "value": 12,
    "unitText": "months"
  }
}

Source: realty-ai.com

Related fields

• offers
• datePosted
• numberOfBedrooms
• floorSize

FAQ

Should I use Duration or QuantitativeValue for leaseLength?

QuantitativeValue is more widely adopted and more readable for AI systems. Use {"@type": "QuantitativeValue", "value": 12, "unitText": "months"} over the ISO 8601 format "P12M". Both are valid per schema.org.

Does leaseLength apply to commercial properties?

Yes. leaseLength works for any accommodation or real estate listing, including commercial leases. A 3-year commercial lease would use {"value": 36, "unitText": "months"} or {"value": 3, "unitText": "years"}.