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

# Units

> How to manage units within a property in BrikSync PropOS. Add, edit, bulk-create, and track unit statuses.

Units are the individual rentable spaces within a property. A property might have one unit (a single house) or many units (an apartment block). Every tenant in BrikSync PropOS is assigned to a specific unit.

***

## Viewing units

1. Go to **Properties** and click the property you want to manage.
2. Scroll to the **Units and Status** section on the property detail page.

You will see a list of all units for that property, each showing:

* **Unit identifier** — e.g. "Flat 1A", "Unit 3", "Ground Floor Office".
* **Status** — available, occupied, maintenance, reserved, or inactive.
* **Current tenant** — name, email, and lease dates if occupied.
* **Monthly rent** — the rent set for that unit's current lease.

The unit list supports **search**, **status filtering**, **property filtering**, and **pagination** (20 units per page).

<Info>Property Managers, Landlords, Admins, and Super Admins can view and manage units.</Info>

***

## Adding a unit

1. From the property's **Units and Status** section, click **Add Unit**.
2. Enter the unit details:
   * **Unit number** — a unique identifier within this property (1–20 characters). Duplicate unit numbers within the same property are not allowed.
   * **Floor** — optional, -10 to 200.
   * **Bedrooms** — number of bedrooms (0–50).
   * **Bathrooms** — number of bathrooms (0–50).
   * **Size (sq ft)** — optional, 1–100,000.
   * **Base rent** — optional, the default rent amount for this unit (up to 1,000,000).
   * **Deposit amount** — optional, the security deposit (up to 10,000,000).
   * **Furnished** — whether the unit comes furnished (defaults to no).
   * **Notes** — optional free-text notes about the unit (up to 2,000 characters).
3. Click **Create Unit**.

The unit will appear in the property's unit list with an **available** status by default.

***

## Bulk-creating units

For properties with many units, you can create multiple units at once:

1. From the property's **Units and Status** section, click **Bulk Create**.
2. Configure the batch:
   * **Prefix** — optional label prefix, up to 8 alphanumeric characters (e.g. "APT-").
   * **Start number** — the first unit number in the sequence (1–99,999).
   * **Count** — how many units to create (1–200).
   * **Shared defaults** — optionally set floor, bedrooms, bathrooms, size, base rent, deposit, and furnished status for all units in the batch.
3. Click **Create Units**.

Units are named using the prefix and sequential numbers (e.g. "APT-1", "APT-2", "APT-3"). If a unit number already exists in the property, it will be skipped rather than causing an error.

The response shows the number of units created and any skipped unit numbers.

***

## Editing a unit

1. Click **Edit** on the unit row in the Units and Status section.
2. Update the relevant fields.
3. Click **Save Changes**.

<Note>
  Editing a unit's details does not affect any active leases. Rent amounts are set on the lease
  itself, not the unit.
</Note>

***

## Unit statuses

| Status          | Description                                                   |
| --------------- | ------------------------------------------------------------- |
| **available**   | The unit has no current tenant and is available to lease.     |
| **occupied**    | The unit has an active lease and an assigned tenant.          |
| **maintenance** | The unit is temporarily offline for repairs or refurbishment. |
| **reserved**    | The unit is held for an upcoming tenant or specific purpose.  |
| **inactive**    | The unit has been decommissioned or is otherwise not in use.  |

To change a unit's status directly, use the inline status selector on the unit row or open the unit and select a new status. This updates only the status field without requiring a full edit.

***

## Unit statistics

A summary of unit counts by status is available at the top of the units view:

* **available** — units ready to lease.
* **occupied** — units with active tenants.
* **maintenance** — units under repair.
* **reserved** — units held for a purpose.
* **inactive** — decommissioned units.
* **total** — all units combined.

You can filter stats by a specific property or view them across your entire portfolio.

***

## Assigning a tenant to a unit

Tenants are assigned to units when you create a lease.

1. Go to **Tenants → Add Tenant** or open an existing tenant record.
2. During lease creation, select the **property** and then the specific **unit**.
3. Enter the lease terms and save.

Once the lease is saved, update the unit's status to **occupied** manually from the unit row.

See the [Leases guide](/features/leases) for full lease creation details.

***

## Vacating a unit

When a tenant's lease ends and they move out, update the unit's status manually to make it available for a new tenant.

Open the unit row and use the inline status selector to set it back to **available** (or **maintenance** if refurbishment is needed first).

<Tip>
  Before advertising a vacant unit for reletting, complete any required maintenance or refurbishment
  and update the unit description if anything has changed.
</Tip>

***

Built by [Errsol Technologies LLP](https://errsol.com)