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

# Buildings

> The Buildings screen lists every building in the property, lets an admin create, edit and delete buildings, see each building's units, and choose who automatically receives form submissions from that building. Found under Properties → Buildings in the RAY admin portal.

## Summary

The **Buildings** screen in the RAY admin portal manages the buildings of a property. A building has
a name, an optional number of floors, an optional project, a map location, images and attachments.
A building's detail page lists its units and whether each unit is occupied. Each building also has
**Submission Recipients**: staff users who automatically receive the forms that tenants submit.

## Where to find the Buildings screen

* Menu: **Properties → Buildings** (Arabic: **العقارات ← المباني**)
* Clicking a building in the list opens the building's detail page.

## Who can access the Buildings screen

The Buildings menu entry is shown only to users with an **Admin** role that includes the buildings
and units feature. The same feature also shows **Projects**, **Units** and **Unit Categories**. The
Buildings screen is never shown to Operator or Security roles. See
[Roles and permissions](/getting-started/roles-and-permissions).

## Buildings list columns

| Column            | Meaning                                                                              |
| ----------------- | ------------------------------------------------------------------------------------ |
| **Project Code**  | Code of the project the building belongs to. Empty when the building has no project. |
| **Building Name** | Name of the building.                                                                |
| Actions           | **Edit** and **Delete** for that building.                                           |

## Building fields

| Field                | Required | Meaning and rules                                                                           |
| -------------------- | -------- | ------------------------------------------------------------------------------------------- |
| **Building Name**    | Yes      | Name of the building.                                                                       |
| **Number of Floors** | No       | Whole number, 0 or more. Shown as **Floors** on the detail page.                            |
| **Project**          | No       | The project the building belongs to, chosen from **Properties → Projects**. Can be cleared. |
| **Location**         | No       | Map pin. Set on the building detail page, not in the create dialog.                         |
| Images               | No       | Photos of the building. Added on the building detail page.                                  |
| **Attachments**      | No       | Any file type, up to 10 MB per file. Added on the building detail page.                     |

## How to create a building

1. Open **Properties → Buildings**.
2. Click **Add**.
3. Enter the **Building Name**.
4. Optionally enter the **Number of Floors** and choose a **Project**.
5. Click **Save**.

The new building appears in the Buildings list. The location, images and attachments are added
afterwards on the building detail page.

## How to edit a building

A building can be edited from the Buildings list or from the building detail page.

1. Open **Properties → Buildings**.
2. Either click **Edit** in the building's row, or open the building and click **Edit** at the top
   of the building detail page.
3. Change the **Building Name**, **Number of Floors** or **Project**.
4. Click **Save**. **Save** stays disabled until something has changed.

On the building detail page, the building name, **Floors**, **Project**, **Location**, images and
**Attachments** can also be edited directly on the page.

## How to delete a building

1. Open **Properties → Buildings**.
2. Click **Delete** in the building's row, or open the building and click **Delete** at the top of
   the building detail page.
3. Confirm the deletion.

## Building detail page

The building detail page shows the building's name, **Floors**, **Project**, images, map
**Location** and **Attachments**, followed by two tabs:

* **Units**: every unit in the building, with columns **Unit Name**, **Category** and **Status**.
  **Category** is the unit category from **Properties → Unit Categories**. **Status** is
  **Occupied** or **Vacant**. Clicking a unit opens that unit's detail page.
* **Submission Recipients**: the staff users who automatically receive form submissions. See the
  next section.

## Building submission recipients

The **Submission Recipients** tab (Arabic: **مستلمو الطلب**) of a building lists staff users with a
**User** and a **Role** column. The portal describes them as follows: "When a tenant submits a form,
the selected user will automatically receive the submission with the selected role."

Each recipient has one **Role**: **Manager**, **Assignee** or **Viewer**. **Manager** is selected by
default.

### How to add a submission recipient to a building

1. Open **Properties → Buildings** and click the building.
2. Open the **Submission Recipients** tab.
3. Click **Add**.
4. Choose the **User**.
5. Choose the **Role**: **Manager**, **Assignee** or **Viewer**.
6. Click **Save**.

To change a recipient's role, edit the recipient in the **Submission Recipients** tab. To stop a
user receiving submissions, delete the recipient from the tab.

## Common questions about Buildings

### Why can't I see the Buildings menu?

The Buildings menu is hidden when none of your roles is an Admin role with the buildings and units
feature. Ask an administrator with access to **Administration → Roles & Permissions** to add that
feature to your role. If you have access to several locations, also check the location selected in
the portal header.

### How do I see which units in a building are vacant?

Open the building from **Properties → Buildings** and look at the **Status** column of the **Units**
tab. Each unit is marked **Occupied** or **Vacant**.

### Is a project required to create a building?

No. **Project** is optional and can be added or cleared later.

### How do I make sure a manager receives every request from a building?

Add the manager as a **Submission Recipient** of that building with the **Manager** role. The
manager then automatically receives the forms that tenants submit.

## Related pages

* [Roles and permissions](/getting-started/roles-and-permissions): who can see the Buildings screen.