What a listing description is not
It is not a list of features (the MLS fields already say there are 4 beds and 2.5 baths). It is not an emotional appeal to a stereotyped buyer ("perfect for your growing family" — Fair Housing violation). It is not a thesaurus exercise ("sun-drenched, gleaming, exquisite").
A listing description is the headline + 3 short paragraphs that answer one question: *why does this specific home deserve the buyer's time to come see it?* That's it.
The 4-paragraph formula
Paragraph 0 — The headline (one sentence):
State the single most marketable physical feature. "Single-story 4-bed with a south-facing yard in {{neighborhood}}." Not "Stunning oasis of luxury living." The buyer skims headlines on Zillow. Be specific.
Paragraph 1 — The home (3–4 sentences):
Walk the buyer through the experience of entering the home. Open floor plan, kitchen, primary suite, outdoor space. Verifiable adjectives only. "Updated kitchen with quartz counters and gas range" — verifiable. "Dream kitchen" — vague filler.
Paragraph 2 — The lot and the systems (2–3 sentences):
Lot orientation, parking, recent system upgrades (roof, HVAC, water heater, electrical), garage. Buyers care. AI cannot guess these — pull from the seller's disclosure.
Paragraph 3 — The location, done right (2–3 sentences):
Distance to MLS-approved POIs (highway, downtown, the {{specific named park}}), commute markers (mins to downtown), school district mention (district name only, not "great schools"). Walking distance to specific public landmarks is fine. Never: demographic descriptors, "exclusive," "safe," "diverse," religious institution proximity, descriptions of who the area is for.
Example: 4-paragraph formula on a real listing
- Headline: "Single-story 4-bed with south-facing pool yard on a 9,800 sqft lot in Yorba Linda."
- P1: "Renovated 2,250 sqft single-story with open kitchen/family room. Quartz counters, gas range, 9-foot ceilings, oak hardwood throughout. Primary suite is on the south side with direct yard access; remodeled primary bath has a separate tub and walk-in shower."
- P2: "Roof replaced 2022, HVAC 2023, tankless water heater, 200-amp electrical panel, 3-car garage with EV outlet. Pool resurfaced 2024."
- P3: "Inside the Placentia-Yorba Linda Unified School District. Three blocks to {{specific park name}}. Twelve minutes to the 91 freeway."
The Fair Housing fence
The Fair Housing Act (42 U.S.C. § 3604) prohibits language that indicates a "preference, limitation, or discrimination" based on race, color, religion, sex, handicap, familial status, or national origin. Many states add age, marital status, sexual orientation, source of income.
Banned in listing copy:
— "Perfect for families" / "great for kids" → familial status.
— "Bachelor pad" / "honeymoon retreat" → familial status / marital status.
— "Walk to {{church name}}" / "near {{synagogue}}" → religion.
— "Exclusive neighborhood" / "safe area" / "stable community" → coded steering language.
— "Mature buyer" / "active adult" (outside of legally-defined 55+ communities) → age.
— "Senior-friendly home" → age / disability.
— Any reference to demographic makeup of the neighborhood, even positive.
Safe:
— Physical features of the home.
— Verifiable lot/system facts.
— Named public landmarks and named school districts (not "schools are great").
— Distance/time to named destinations.
AI-generated copy: extra caution
Generic AI models trained on the public web will reproduce Fair Housing-violating language unless explicitly constrained. Every AI listing-description deployment needs (1) a system prompt that lists banned phrases, (2) a post-generation regex or classifier check for known violations, and (3) human Fair Housing review before MLS upload. This is operational guidance; coordinate with a US real-estate attorney.
Localization for bilingual MLS
If your market has bilingual MLS or a strong Spanish-speaking buyer pool, run a Spanish version of the same description. Three rules:
1. Translate the structure, not the words. "Open floor plan" in real-estate Spanish is "planta abierta" — not a word-for-word translation. Use a real-estate-trained translator (human or AI), not Google Translate.
2. Apply Fair Housing in both languages. "Ideal para familias" is just as illegal as "perfect for families." The ban is on intent, not language.
3. Match the buyer's frame. Lot size in m² where the Spanish-speaking buyer pool is from a metric country; sqft elsewhere. School district names in English (because they're English-named) but with a Spanish lead-in ("Dentro del distrito escolar...").
Measuring whether the description works
Two metrics, easy to pull from MLS analytics:
1. Click-through rate from gallery view to detail page. If your photos are good but CTR is low, the description headline is failing.
2. Detail page to showing requested. If buyers land on the detail page but don't request a showing, the body copy is either vague, has Fair Housing issues that turn off agents, or misrepresents the photos.
A/B test the headline first; it's the highest-leverage edit. Then test the first paragraph. The lot/systems paragraph rarely needs A/B testing — it's informational.