> ## 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.

# Properties

> How to add, edit, and manage properties in BrikSync PropOS. Includes property types, plan limits, and portfolio management.

Properties are the foundation of your BrikSync PropOS portfolio. Each property represents a physical address that you own or manage, which can contain one or more rentable units.

***

## Plan limits

| Plan     | Max properties |
| -------- | :------------: |
| FREE     |        3       |
| PRO      |       25       |
| BUSINESS |    Unlimited   |

<Note>
  If you have reached your plan's property limit, you will be prompted to upgrade your plan when
  attempting to add a new property. See [Plans & Pricing](/plans-and-pricing) for more details.
</Note>

***

## Adding a property

1. Go to **Properties** in the left sidebar.

2. Click **Add Property**.

3. Complete the property form:
   * **Property Name** — a clear, recognisable label (e.g. "Elmwood Court"). 1–200 characters.
   * **Address** — street address (line 1 required, line 2 optional), city, state, postal code, and country.
   * **Property Type** — select from the options below.
   * **Number of Units** — the total number of rentable units at this address (1–10,000).
   * **Description** — optional, up to 2,000 characters. Tenants and managers may see this.
   * **Year Built** — optional (1800 to two years ahead), used for reporting.
   * **Cover Image** — optional. Accepts JPEG, PNG, or WebP up to 10 MB. EXIF metadata is automatically stripped for privacy.

4. Click **Save Property**.

The property will immediately appear in your portfolio. The new property is automatically linked to your account so it appears in your portfolio right away.

<Info>Landlords, Admins, and Super Admins can add properties.</Info>

***

## Property types

BrikSync PropOS supports the following property types:

| Type            | Description                                              |
| --------------- | -------------------------------------------------------- |
| **Residential** | Single-family homes, flats, apartments, student housing. |
| **Commercial**  | Office space, retail units, warehouses.                  |
| **Industrial**  | Factories, distribution centres, workshops.              |
| **Mixed Use**   | Buildings with both residential and commercial units.    |

***

## Property detail page

Click any property to view its full detail page. The detail view includes:

* **Property profile** — name, address, type, description, and cover image.

* **Units** — all units with status, tenant name, active lease, and monthly rent.

* **Occupancy breakdown** — total, occupied, available, maintenance, reserved, and inactive unit counts with an occupancy rate percentage.

* **Financials** — financial summary visible to Admin and Super Admin roles only. The summary shows the number of active leases, the count of occupied units, the total monthly rent roll, and the average rent per occupied unit.

* **Maintenance history** — recent maintenance requests for the property.

* **Documents** — property-level documents with upload and download capabilities.

<Info>
  Landlords, Admins, and Super Admins can access the property detail page. If the property is not
  found or you do not have access, you will see a "Property not found" message.
</Info>

***

## Listing and filtering properties

The property list supports both **grid** and **map** views with the following filters:

| Filter           | Description                                                                      |
| ---------------- | -------------------------------------------------------------------------------- |
| **Search**       | Free-text search by property name or address (up to 200 characters).             |
| **Type**         | Filter by Residential, Commercial, Industrial, or Mixed Use.                     |
| **City**         | Filter by city name (up to 100 characters).                                      |
| **Rent range**   | Minimum and maximum rent values.                                                 |
| **Amenities**    | Filter by amenity tags (up to 20 items).                                         |
| **Availability** | Show all, available, occupied, maintenance, or reserved.                         |
| **Radius**       | Geo-radius filter using centre latitude/longitude and distance in km (1–200 km). |

Results support sorting by name, creation date, city, type, or total units in ascending or descending order, and are paginated (up to 100 items per page).

### Visibility by role

| Role                            | Properties visible                  |
| ------------------------------- | ----------------------------------- |
| **Super Admin / Admin**         | All properties in the organisation. |
| **Landlord / Property Manager** | Only properties assigned to you.    |

***

## Editing a property

1. Go to **Properties** and click the property you want to edit.
2. Click the **Edit** button in the top-right corner.
3. Update any fields as needed.
4. Click **Save Changes**.

All changes are saved immediately and reflected across the platform, including the tenant portal.

***

## Managing units within a property

Once a property is created, you can add and manage its individual units from the **Units and Status** section on the property's detail page.

Each unit can be:

* **available** — ready to be assigned to a new tenant.
* **occupied** — assigned to a current tenant with an active lease.
* **maintenance** — temporarily offline for repairs.
* **reserved** — held for an upcoming tenant or purpose.
* **inactive** — decommissioned or otherwise not in use.

See the [Units guide](/features/units) for full details.

***

## Property comparison (Pro and Business)

Use side-by-side comparison to evaluate up to 4 properties across occupancy, rent, lease, and maintenance health.

1. Go to **Properties**.
2. Click **Compare**.
3. Select **2 to 4 properties**.
4. Click **Compare Selected**.

The comparison view includes the following metrics for each selected property:

| Metric                        | Description                                                      |
| ----------------------------- | ---------------------------------------------------------------- |
| **Occupancy rate**            | Percentage of units currently occupied.                          |
| **Unit status breakdown**     | Occupied, available, maintenance, reserved, and inactive counts. |
| **Listed rent range**         | Minimum and maximum listed rent across units.                    |
| **Average unit rent**         | Mean rent per unit.                                              |
| **Monthly rent roll**         | Total monthly rental income.                                     |
| **Active leases**             | Number of currently active lease agreements.                     |
| **Open maintenance requests** | Number of unresolved maintenance issues.                         |

<Note>
  Property comparison is available on **Pro** and **Business** plans with an active or trialing
  subscription. Free plan users will see an upgrade prompt.
</Note>

<Warning>
  Landlord and Property Manager users can only compare properties that are assigned to them.
  Attempting to compare properties you do not have access to will return an error.
</Warning>

***

## Deleting a property

Deleting a property removes it from your active views while preserving all associated data — leases, payments, and maintenance records are retained for your records.

Only **Super Admin** and **Admin** roles can delete a property.

***

## Brochure link analytics

You can share a property brochure with external parties via a unique link. Each brochure link includes built-in analytics so you can track engagement.

### Sharing a brochure

1. Open the property detail page and click **Brochure** (or navigate directly to the property's brochure page).
2. Click **Share Brochure**.
3. Copy the generated link and send it to your contact.

Each link is identified by a unique token and **expires automatically after 7 days**. You can revoke a link at any time from the brochure page by clicking **Revoke Link**.

### Viewing analytics

For each brochure link you can see:

| Metric          | Description                                                                                                                  |
| --------------- | ---------------------------------------------------------------------------------------------------------------------------- |
| **View count**  | The number of times the brochure has been opened.                                                                            |
| **Last viewed** | The date and time the brochure was most recently viewed.                                                                     |
| **Expires**     | When the link will automatically stop working (7 days from creation).                                                        |
| **Status**      | Whether the link is currently active, expired, or revoked. Expired links display a clear "link expired" message to visitors. |

<Note>
  Brochure link analytics are available to all roles that can view the property detail page. Super
  Admins, Admins, and Landlords can create brochure links. Revoking a link requires an Admin or
  Super Admin.
</Note>

***

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