> For the complete documentation index, see [llms.txt](https://docs.mymagma.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.mymagma.com/features/dashboard.md).

# Buildings Dashboard

The Buildings Dashboard is your central hub for managing all the properties you have access to on the Magma platform. It provides a high-level overview of every building in your portfolio, with quick access to each building's features, status indicators, and management actions.

***

## Accessing the Dashboard

After logging in, the Buildings Dashboard is the first screen you see. You can also return to it at any time by clicking the Magma logo or the **Buildings** item in the main navigation.

***

## View Modes

The dashboard supports two view modes, toggled via the layout switcher in the top-right toolbar:

### Grid View (Default)

Buildings are displayed as cards arranged in a responsive grid. Each card provides a visual snapshot of the building:

* **Cover image** — The building's cover photo (set via the Gallery feature). If no cover has been set, a default placeholder is shown.
* **Building name** — Displayed prominently below the image.
* **Address** — City and country of the building.
* **Building type** — One of the 9 supported types: Hotel, Public, Industrial, Warehousing, Mixed Use, Commercial, Residential, Office, or Medical.
* **Magma Index** — A circular progress indicator showing the overall documentation completeness score for the building.
* **Status badge** — Reflects the current operational status of the building (see Status Colors and Icons below).
* **Quick action menu** — A three-dot (⋯) menu giving access to building-level actions without needing to open the building.

### Table View

Buildings are displayed as rows in a sortable table. Each row includes the following columns:

| Column        | Description                                                |
| ------------- | ---------------------------------------------------------- |
| Building Name | Clickable link to open the building                        |
| Address       | Full address or city/country                               |
| Type          | Building type label                                        |
| Magma Index   | Numeric score (%)                                          |
| Stakeholders  | Count of registered stakeholders                           |
| Status        | Status badge (see below)                                   |
| Subscription  | Current subscription plan (Essential / Premium / Infinity) |
| Actions       | Quick action icons                                         |

Table view is particularly useful when managing large portfolios, as it allows faster scanning and sorting across many buildings.

***

## Building Status Colors and Icons

Each building card or row displays a status indicator that reflects its current state:

| Status   | Color         | Description                                                                                                       |
| -------- | ------------- | ----------------------------------------------------------------------------------------------------------------- |
| Active   | Green         | The building is fully operational and all features are accessible.                                                |
| Overdue  | Orange/Yellow | A payment has failed. Certain features may be restricted depending on how many days the payment has been overdue. |
| Archived | Red / Gray    | The building has been archived due to extended non-payment (day 60). All features are disabled.                   |
| Paused   | Gray          | The subscription has been manually paused.                                                                        |
| Canceled | Red           | The subscription has been canceled and will not renew.                                                            |

> **Note:** Buildings in Overdue or Archived status display a banner inside the building explaining which features are restricted and what action is required.

***

## Filters

The dashboard includes a filter bar above the building grid or table. Available filters:

### Search

A full-text search field that filters buildings by name or address as you type.

### Building Type

A dropdown or multi-select filter allowing you to show only buildings of a specific type (e.g., only Residential buildings, or only Office and Commercial).

### Status

Filter by the building's current status: Active, Overdue, Paused, Canceled, or Archived.

### Subscription Plan

Filter by the plan tier: Essential, Premium, or Infinity.

### My Role

When enabled, shows only buildings where you have an active stakeholder role assigned.

Filters can be combined. The result count updates dynamically as filters are applied.

***

## Sorting

In table view, click any column header to sort by that field. Clicking a second time reverses the sort order (ascending/descending). In grid view, a sort dropdown is available in the toolbar with the following options:

* **Alphabetical (A → Z)**
* **Alphabetical (Z → A)**
* **Newest first** — Based on building creation date.
* **Oldest first** — Based on building creation date.
* **Last modified** — Based on the most recent activity within the building.
* **Magma Index** — Highest score first.

***

## Actions Per Building

### From the Card / Row

* **Open building** — Click the building name, card, or row to navigate into the building and access all its features.
* **Quick actions menu (⋯)** — Available on hover or via right-click on a card; available as an icon column in table view:
  * **Edit building info** — Update the building's name, address, type, or cover image.
  * **Manage stakeholders** — Open the stakeholder management panel directly.
  * **View subscription** — Open the subscription details modal.
  * **Archive building** — Manually archive a building (requires Owner or Account Manager role).
  * **Delete building** — Permanently delete the building (irreversible; requires Owner role and confirmation).

### Creating a New Building

The **+ New Building** button is prominently placed in the top-right of the dashboard. Clicking it launches the 5-step Building Creation wizard. See the [Building Creation](/features/building-creation.md) guide for full details.

***

## Empty States

### No Buildings Yet

When your account has no buildings, the dashboard displays an illustrated empty state with the message:

> "You don't have any buildings yet. Create your first building to get started."

A **Create Building** call-to-action button is displayed in the center of the page.

### No Results After Filtering

If the active filters return no matching buildings, the dashboard displays:

> "No buildings match your filters."

A **Clear Filters** button allows you to reset all active filters in one click.

***

## Building Card — Detailed Breakdown

In grid view, hovering over a building card reveals additional interaction affordances:

| Element         | Location           | Description                                             |
| --------------- | ------------------ | ------------------------------------------------------- |
| Cover image     | Top of card        | Full-width photo; clicking opens the building.          |
| Status badge    | Top-right overlay  | Color-coded dot or label indicating operational status. |
| Building name   | Below image        | Bold text; clickable.                                   |
| Building type   | Below name         | Small label in a neutral color.                         |
| Address         | Below type         | City and country.                                       |
| Magma Index     | Bottom of card     | Circular progress ring with percentage label.           |
| Action menu (⋯) | Top-right on hover | Reveals the quick action dropdown.                      |

***

## Tips for Large Portfolios

* Use **Table View** for faster scanning when managing 10+ buildings.
* Use the **Building Type** and **Status** filters together to prioritize buildings requiring attention (e.g., filter to Overdue + all types).
* The **Magma Index** score helps identify buildings with incomplete documentation — sort by index to find those needing the most work.
* Pin frequently accessed buildings using the star/bookmark icon (if available on your plan) to keep them at the top of the grid.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.mymagma.com/features/dashboard.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.