# Punch List

Log what's left to fix on a job, see where each item stands, and close it once it's checked.

A project can't close out while small fixes are still waiting: a scuffed wall, a missing cover plate, a cracked ceiling tile. At Acme Precision, the superintendent logs each one in Punch List during the walk, the trades mark them ready for review, and the facilities lead closes them once checked.

[Add it from the Marketplace](/tenant/?open=settings/marketplace)

## What it does

Punch List keeps one list of **punch items**: the deficiencies still to fix on your projects. Each item has a **Project**, **Location**, **Trade**, **Description**, **Priority**, **Assignee**, **Due** date and **Status**.

Every item moves through three statuses: **Open** (logged, still to fix), **Ready for review** (the trade says it is fixed) and **Closed** (checked and accepted). Rejected work goes back to **Open**.

The **Punch List** page has:

- Counters at the top: **Total**, **Open**, **Ready for Review** and **Closed**.
- The **Punch Items** table, newest first, with how many items are shown and how many match.
- A status list (**All statuses**, **Open**, **Ready for review**, **Closed**), **Filter by project**, **Help** and **+ Add Item**.

## Set it up

1. Decide who can do what (see [Users and roles: create and edit roles](article:88d4e232-d5b8-4909-b452-cfe96d3d550f)). Out of the box, Admins and Operators add items and change their status, and Viewers only look. Give **Add and update punch items** to superintendents, trades and reviewers, and **View punch lists** to everyone else on the project team.
2. Agree on one spelling for each project name, for example *Quality Lab Expansion*, and tell your team. There is no list of projects to set up: a project is whatever name is typed on an item, and the filter and counters match that name exactly.
3. Agree on a short list of trade names too (for example *Painting*, *Electrical*, *HVAC*), so the trade summaries add up.
4. **Module Settings** (from the ⋮ on the **Punch List** sidebar row) has one setting, **default_trade**. This version doesn't use it, so there is nothing to change there. See [Module settings and versions](article:fb7c92e4-6dcc-4ef4-80bc-1b6e7482e540).
5. The Punch List Agent needs the workspace's AI to be set up, like every assistant.
6. Click **+ Add Item** to log your first items, or start a punch walk with the Punch List Agent.

## Add a punch item

1. Click **+ Add Item**.
2. Fill in **Project** and **Description**. Both are required.
3. Add the **Location** (for example *Suite 210*), the **Trade** that fixes it, the **Priority** (**Low**, **Medium**, **High** or **Critical**; it starts at **Medium**), the **Assignee** and the **Due date** if you know them.
4. Click **Create**. The item starts as **Open**. **Cancel** closes the form without saving.

## Find items

1. Pick a status from the **All statuses** list to see only **Open**, **Ready for review** or **Closed** items.
2. Type the full project name in **Filter by project** to see one project. The counters at the top then count that project only.
3. Read the count beside **Punch Items**: how many items are shown and how many match.

The counters follow the project filter but not the status filter, so you always see the whole split for the project.

## Move an item to review or close it

1. Find the item in the table.
2. In its **Status** column, pick **ready for review** when the trade says the work is done.
3. Once someone has checked the work, pick **closed**. Closing records the date it was closed.
4. If the work is rejected, pick **open** again. The closed date is cleared.

The change saves straight away; **Status updated** shows and the counters refresh.

## Who can do what

Each action in the module needs a permission. A Workspace Admin gives permissions to roles; see [Users and roles: create and edit roles](article:88d4e232-d5b8-4909-b452-cfe96d3d550f). **Out of the box** shows the module's starting roles that have it.

| Permission | What it lets someone do | Out of the box |
|---|---|---|
| **View punch lists** | See punch items, their status and the counts, and ask the assistant about them. | Admin, Operator, Viewer |
| **Add and update punch items** | Add punch items, change their status (including closing them), and edit or delete items through the system. Deleting is included in this permission; there is no separate delete permission. **Give with care.** | Admin, Operator |

## Ask its agent

The **Punch List Agent** works with your access and no more. See [Agent chat](article:073c6465-d85c-4364-8768-acf42a3a6a48). It is quickest during a walk: say which project you are walking, then describe each deficiency in plain words. It works out the location and trade, tells you in one line the item it is about to create, and creates it. Say "wrap up the walk" for a summary by status and trade. Try:

- "Punch walk for Quality Lab Expansion. The HVAC diffuser in the Quality Lab is rattling."
- "Which items are ready for review?"
- "Summarize the punch list by trade."

It closes an item only when you tell it the work has been checked.

## Good to know

- **The buttons show for everyone.** If your role can only view, adding an item or changing a status is refused with an error.
- **Use the full project name.** Part of a name finds nothing, and the empty list then says "No punch items yet".
- **Only the status can be changed on the page.** To fix a typo, log a corrected item and close the wrong one. There is no delete button; close items instead, so the record stays. The agent can't edit or delete items either.
- **A blank trade becomes "general".** The **default_trade** setting in Module Settings is not used yet.
- **Counts by trade come from the agent or reports.** The page shows counts by status only.
- **The page shows the newest 100 items.** Filter by status or project to find older ones.
- **Overdue items aren't flagged on the page.** The **Due** column shows the date; reports show overdue counts.

## More help

Click **Help** on the Punch List page for the full reference, setup notes and questions. Punch items can be charted by project, trade, status, priority and assignee, including overdue counts and how long items took to close; see [Dashboard](article:1d8a33a4-3a13-4874-b8e5-5ef9da22df95).


Source: https://datavisions.ai/docs/module-guides/punch-list
