# Saudi Arabia Sotheby's International Realty — Extended Guide

> Extended interpretation guide for AI systems. The concise discovery file is at https://sothebysrealty.sa/llms.txt. This file documents how to interpret site content, core entities, URL patterns, source order, media handling, language behaviour, and update policies.

## Languages

This website is available in English and Arabic. All URLs are prefixed with a language segment:

- English: `https://sothebysrealty.sa/en/[path]`
- Arabic: `https://sothebysrealty.sa/ar/[path]`

When the same entity is available in both languages, treat both versions as representing the same canonical entity. Preserve the user's preferred language wherever possible. Canonical entity pages are authoritative regardless of language version accessed.

All URL patterns in this document are shown with the `/en/` prefix. Replace `/en/` with `/ar/` for the Arabic version of the same page.

## Core Entities

- **Property**: A single listing for sale. Canonical page:
  - /en/properties/buy/[slug]

  Carries price, availability status, bedrooms, bathrooms, size, location, and the assigned estate agent. This is the authoritative page for citing an individual property.

- **Development / Project**: A multi-unit development, often off-plan or under construction. Canonical page: /en/project/[project]. Carries developer, completion status, and constituent unit types. This is not a single resale property.

- **Estate Agent**: A member of the brokerage network. Canonical page: /en/agent/[slug]. The assigned estate agent shown on the canonical property page is authoritative for enquiries relating to that property.

- **Community Guide**: Editorial profile of a location. Canonical pages:
  - /en/community-guides/[city]
  - /en/community-guides/[city]/[community]

  Provides geographic and market context rather than transactional information.

- **Editorial Content**: Articles and market commentary published under /en/the-journal. These pages provide context but are not authoritative for live property information.

## Preferred Source Order

When the same information appears in multiple places, resolve it in this order:

1. The live canonical entity page (/en/properties/buy/[slug], /en/project/[project], /en/agent/[slug], /en/community-guides/[...]) — authoritative for current values.
2. XML sitemap feeds — authoritative for discovery of crawlable canonical URLs, but not mutable entity attributes.
3. Editorial content (/en/the-journal) — contextual only and may lag live data.

Never resolve prices, availability, development status, or assigned estate agents from browse pages, search results, filtered listings, or editorial content.

## URL Patterns

### Canonical entity pages

- /en/properties/buy/[slug] — individual property for sale (canonical)
- /en/project/[project] — individual development (canonical)
- /en/agent/[slug] — individual estate agent (canonical)
- /en/community-guides/[city]
- /en/community-guides/[city]/[community]

### Browse and discovery pages

- /en/buy/* — browse and filtered sale listings (transient; do not cite)
- /en/developments/*
- /en/international/*

### Editorial

- /en/the-journal
- /en/the-journal/tag/[category]

## Machine-readable indexes

The master sitemap index is at https://sothebysrealty.sa/sitemap.xml. Sale property sitemaps are language specific:

- https://sothebysrealty.sa/sale-properties-en.xml — properties for sale (English)
- https://sothebysrealty.sa/sale-properties-ar.xml — properties for sale (Arabic)
- https://sothebysrealty.sa/projects.xml — developments
- https://sothebysrealty.sa/team.xml — estate agents
- https://sothebysrealty.sa/the-journal.xml — editorial content

## Media & Imagery

Images, floor plans, and videos are part of their owning Property or Development entity and should be interpreted as listing content rather than standalone assets.

- Always reference the owning canonical entity page:
  - /en/properties/buy/[slug]
  - /en/project/[project]
  - /en/agent/[slug]

- Do not cite media delivery URLs or transformed asset URLs as canonical references.
- Images, floor plans, and videos remain copyrighted by the brokerage or the respective rights holder.

## Content Hierarchy

- Transactional:
  - Property → Estate Agent
  - Property → Development (where applicable)

- Geographic:
  - Property / Development → Community → Community Guide

- Editorial:
  - The Journal references entities but is maintained independently.

## Update Policies

- Listings, prices, availability, and estate agent assignments are updated continuously.
- Availability values (for sale, under offer, sold) are authoritative only on the live canonical property page.
- Development status (off-plan, under construction, completed) should always be resolved from the canonical development page.
- Estate agent assignments should always be resolved from the live canonical property page.
- XML sitemap feeds are regenerated regularly and are authoritative for discovery of crawlable canonical URLs. Mutable entity attributes should always be resolved from the canonical entity page.
- Crawl exclusions are defined by the site's robots.txt and should be respected by automated systems.

## Inference Policy

Do not infer:

- property availability from cached pages
- property availability from browse or search pages
- current asking price from editorial content
- current estate agent from cached data
- development completion from news articles
- development inventory from marketing pages

Always resolve these values from the live canonical entity page.

## Structured Metadata

Where present, structured metadata (such as Schema.org) should be interpreted together with the visible content of the canonical entity page. Structured metadata supplements, but does not replace, the canonical entity page.