# How to Edit a Scaffold

## Purpose

Provide a controlled, permission-based way to update scaffold records (dates, dimensions, location, attachments, and boards) after they have been created.

***

## How to Access

**Sites** → **Select Site** → **Scaffolds Tab** → **Select Scaffold** → **Settings** (⚙️) → **Edit Scaffold**

<div align="left" data-with-frame="true"><figure><img src="https://3532476255-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsVJ0qURLvzCOxTGXEZIZ%2Fuploads%2F8qtRJOLBtT8GpyWL1VMQ%2FScreenshot%202026-01-20%20at%2012.13.37.png?alt=media&#x26;token=28fc911c-493f-411f-b17b-6521373e6079" alt=""><figcaption></figcaption></figure></div>

***

## Overview

1. Go to **Sites** and select the site you want to work on.
2. On the site page, open the **SCAFFOLDS** tab.
3. In the relevant lifecycle accordion (for example **Pending Scaffolds**), click the scaffold **Code** to open the scaffold record.
4. On the scaffold record, click the **Settings (⚙️)** icon in the top-right to open the edit screen.&#x20;
5. Make changes and click **UPDATE** in the bottom-right to save.

***

## Step-by-Step Workflow

<div align="left" data-with-frame="true"><figure><img src="https://3532476255-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsVJ0qURLvzCOxTGXEZIZ%2Fuploads%2FPYmdJ2oLO71JSle2V3mB%2FScreenshot%202026-01-20%20at%2012.14.07.png?alt=media&#x26;token=127ba473-99ed-407e-ba11-c842d3a1e6cc" alt=""><figcaption></figcaption></figure></div>

Once the **Edit Scaffold** form is open, you can update the following sections.

### Scaffold Details

#### Update Erection Date (Required)

* Click **Erection Date**
* Select the correct date from the date picker
* This field must remain completed to save

#### Update Dismantle Date (Required)

* Click **Dismantle Date**
* Select the planned dismantle date
* This field must remain completed to save

#### Use Hire (Optional)

* Toggle **Use Hire** ON if you want hire values to apply to this scaffold
* Update hire-related values as needed (if enabled)

> Using **Use Hire** is optional. If you do not wish to track hire costs, leave it OFF and no hire calculations will apply.

#### Update Description (Optional)

* Update the scaffold description (example: “Main building”)

#### Update Location (Optional)

* Update the physical location on site (example: “North elevation”)

#### Update Scaffold Type

* Open the **Scaffold Type** dropdown
* Select the correct scaffold type

#### Update Dimensions (Required)

Update any scaffold measurements as needed:

* **Length**
* **Width**
* **Height**

> The system supports metres (m) and feet (ft) and will automatically handle the conversion based on your account settings.

#### Weight (Optional)

* Enter or update **Weight (kg)** if you track scaffold weight for reporting

***

### Attachments (Optional)

Attachments are used to represent additional connected scaffold structures (example: cantilevers).

#### Edit an existing attachment

* Update the attachment fields (description, location, type, dimensions, level, weight)
* Use **Delete** to remove an attachment if it should no longer be linked

#### Add a new attachment

* Click the green **+** button in the Attachments section
* Complete the attachment fields

> The **Level** field on an attachment represents the height of the attachment above ground level or from the base of the structure.

***

### Boards Details

The **Boards Details** section records boards/platforms/working levels installed on the scaffold.

#### Edit an existing board item

* Update any of the board fields (description, length, width, level, qty)

#### Add another board item

* Click the green **+** button to add another board level

#### Delete a board item

* Click **Delete** to remove a board item if it was added in error

***

### Save Changes

1. Review your updates
2. Click **UPDATE** in the bottom-right to save the scaffold

<div align="left" data-with-frame="true"><figure><img src="https://3532476255-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsVJ0qURLvzCOxTGXEZIZ%2Fuploads%2FHiEuIriGDe19xnn4l6v7%2FScreenshot%202026-01-20%20at%2012.23.52.png?alt=media&#x26;token=553b6adf-b554-4a38-955b-cbb076258948" alt="" width="179"><figcaption></figcaption></figure></div>

***

### What Happens Next

After clicking **UPDATE**:

* The scaffold record is updated immediately
* The scaffold overview and related lists (scaffold register/logs) reflect the latest values
* Any changes to dates, dimensions, attachments, or boards will be used in reporting going forward

***

## Permissions Required

Permissions related to accessing job sites, viewing scaffolds, and updating scaffold records.

| Section          | Permission | What this allows the user to do            |
| ---------------- | ---------- | ------------------------------------------ |
| Sites: Sites     | View       | View site details and site lists           |
| Sites: Scaffolds | View       | Access scaffold lists and scaffold records |
| Sites: Scaffolds | Update     | Edit and update existing scaffolds         |

***

## Troubleshooting and Common Questions

| Issue                                  | Likely cause                                                    | Resolution                                                                           |
| -------------------------------------- | --------------------------------------------------------------- | ------------------------------------------------------------------------------------ |
| Scaffolds tab is missing               | Insufficient permissions                                        | Request **Sites: Scaffolds → View** permission                                       |
| Settings (⚙️) / Edit option is missing | Update permission not granted                                   | Request **Sites: Scaffolds → Update (Edit)** permission                              |
| UPDATE does not save                   | A required field is blank (dates/dimensions)                    | Confirm **Erection Date**, **Dismantle Date**, and required dimensions are filled in |
| Cannot edit scaffold                   | Scaffold is inactive/dismantled (or restricted by your process) | Check scaffold status and confirm your role allows editing that lifecycle stage      |