> ## Documentation Index
> Fetch the complete documentation index at: https://docs.majarrah.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Projects

> Group your properties by development, phase, or master community.

## What is a project?

A **project** is a container for related properties — a single tower, a compound release, or a full master-planned community. Every property in your workspace belongs to exactly one project. Widget answers, AI verdicts, and reporting all roll up per-project.

## Create a project

From the sidebar, open **Projects → New project**.

<Steps>
  <Step title="Name and slug">
    Give the project a display name (Arabic + English) and a short slug. The slug shows up in URLs and in the AI's replies to buyers.
  </Step>

  <Step title="Location">
    Pick the city and district using Majarrah's location picker. The city/district feed price benchmarks and market comparisons in the AI answers.
  </Step>

  <Step title="Cover imagery">
    Add a hero image and a short marketing blurb. This is what buyers see when the widget references the project.
  </Step>

  <Step title="Delivery details (optional)">
    Add expected handover date, payment plan summary, and off-plan status. The AI cites these when buyers ask about timing or terms.
  </Step>
</Steps>

## Add properties to a project

Every property you add via **Properties → New listing** is attached to one project. If you have multiple projects, pick from the dropdown at the top of the form. Unit specs (bedrooms, bathrooms, area) are per-property; project-level info (payment plan, delivery date) is inherited.

## Project analytics

Open a project to see:

* Unit availability status
* Views by property
* Inquiries per unit
* New leads captured for this project
* Widget messages mentioning this project by name

## Public project page

Every project has a public URL: `<yourslug>.majarrah.io/projects/<project-slug>`. Buyers can browse, filter units, and start a conversation with the widget from this page.

<Note>
  Projects are not visible on the public Majarrah marketplace until at least one property inside them is published and moderation-approved.
</Note>