Projects
A project is the central unit of work in KNX Clarity. Everything else — rooms, devices, group addresses, ETS files, service cases, comments, activity, attachments — hangs off a project. Every project belongs to exactly one organisation and, optionally, one customer.
The projects list
Click Projects in the sidebar to see every project in your organisation. The list is sorted by most recently updated.
You can filter by:
- Status —
active,completed,archived,escrow. - Customer — a dropdown of every customer in the org.
- Free text — matches project name, building name, and description.
Click any project card to open its detail page.
Creating a project
Click New project in the top-right. The minimum required field
is the name; the rest can be filled later. A newly-created project
starts with status active and an empty buildingAddress.
| Field | Notes |
|---|---|
| Name | Required. Shown everywhere the project is referenced. |
| Customer | Optional. Pick from the org's customer list. |
| Building name | Optional. Used as a secondary title in the detail. |
| Building address | Optional, free text. |
| Description | Optional, free text. |
The project detail
A project detail page is organised into tabs. The tabs you see
depend on what you have permission to do in that project, but for
an admin member of the owning org the full set is:
- Overview — KPIs, description, customer link, quick actions.
- ETS files — upload + version history. See ETS files.
- Rooms & devices — the parsed building structure. See Rooms & devices.
- Group addresses — the parsed KNX group address table. See Group addresses.
- Service cases — tickets scoped to this project. See Service cases.
- Comments — free-form project discussion.
- Activity — a filtered feed of the project's history.
- AI assistant — a chat scoped to this project. See AI assistant.
Changing status
Use the status dropdown in the top-right of the detail page to move between the four lifecycle states:
active— the default state, all features enabled.completed— the project is done but still visible; most writes are still allowed so you can tie off lingering service cases.archived— the project is hidden from the default list filter and becomes read-only. You can un-archive at any time.escrow— the project is parked pending a transfer to another organisation. See Escrow & transfers.
Adding a description inline
The description card on the Overview tab supports inline edit for
anyone with admin or technician role. Click the pencil icon,
type, and click Save. Markdown is not rendered in the
description — it is a plain text field.
Deleting a project
Click ⋮ → Delete project in the top-right of the detail page. The confirmation dialog asks you to type the project name exactly to avoid accidents. Deletion is hard for beta — the project row, all its children, and all its attachments are removed. Export anything you want to keep before confirming.
There is no undo for project deletion in the current beta. If you delete a project by mistake, open a support ticket within 24 hours — we keep an encrypted Aurora backup for that window.