Simple Wires Help

- Getting Started: /manual/docs/getting-started.html
- Projects Dashboard: /manual/docs/projects.html
- Sharing Projects: /manual/docs/sharing.html
- Drawings and the Start Page: /manual/docs/drawings.html
- The Drawing Editor: /manual/docs/editor.html
- Functional Blocks and Ports: /manual/docs/blocks.html
- Master Library: /manual/docs/equipment-library.html
- Warehouses: /manual/docs/warehouses.html
- Racks and Rack Panels: /manual/docs/racks.html
- Drawing Cables: /manual/docs/cables.html
- Off Sheet Pointers: /manual/docs/off-sheet-pointers.html
- Shapes, Text and Images: /manual/docs/shapes-text-images.html
- Page Setup and Drawing Settings: /manual/docs/page-setup.html
- Printing and Exporting: /manual/docs/print-export.html
- Project Data Grids: /manual/docs/project-data.html
- Signal Types: /manual/docs/signal-types.html
- Drawing Revisions: /manual/docs/revisions.html
- Teams: /manual/docs/teams.html
- Billing and Plans: /manual/docs/billing.html
- Your Account: /manual/docs/account.html
- Themes and Appearance: /manual/docs/appearance.html
- Keyboard Shortcuts: /manual/docs/keyboard-shortcuts.html
- FAQ and Troubleshooting: /manual/docs/faq.html


# Drawing Revisions

Simple Wires keeps earlier saved versions of each drawing, called revisions. Use them to see who changed a drawing and when, to note why, and to go back to an earlier version.

## How revisions are recorded

Every time a drawing is saved, whether you press <kbd>Ctrl</kbd>+<kbd>S</kbd> or the drawing is saved automatically, Simple Wires stores a copy of it as a revision. The revision records the date and time, the drawing's name and preview at that moment, and who saved it.

Automatic saves can happen every few seconds, so revisions are grouped by the minute. If a drawing already has a revision from the last minute, a new save replaces that revision instead of adding another. The result is at most one revision per minute of work.

Simple Wires keeps the 64 most recent revisions of each drawing. When a save creates a 65th, the oldest revisions are removed, except revisions marked **Do Not Purge**.

## Open the Drawings and Revisions grid

In the drawing editor or on the Start Page, choose **Project Data > Drawings and Revisions**. If a drawing is open, it is saved first.

{{< screenshot name="revisions-grid" alt="The Drawings and Revisions grid listing the project's drawings" >}}

The grid lists every drawing in the project, in name order, with its **Name**, **Description**, **Date Created**, **Last Modified**, and **Has Revisions**.

- Type in the search box above the grid to find a drawing, or type in the filter row under the column headings to filter by one column.
- Drag a column border to resize it.
- To export the list to Excel, choose **File > Export to Excel**.

To go back to drawing, open a drawing from the Start Page (**View > Start Page**). For the other Project Data grids, see [Project Data Grids]({{< relref "project-data" >}}).

## View a drawing's revisions

Click the arrow at the left of a drawing's row. The row expands to show **Drawing Revisions for:** and the drawing name, with the newest revision first.

{{< screenshot name="revisions-detail" alt="A drawing row expanded to show its revisions with previews, notes and the Revert to this version button" >}}

Each revision shows:

- **Revision Date**: when it was saved, shown in GMT.
- **Name (at time of revision)**: the drawing's name when it was saved.
- **Revised By**: the user who saved it.
- **Notes - Editable**: your notes about the revision.
- **Image**: a preview of the drawing at that point.
- **Action**: **Revert to this version** and **Delete this revision**.
- **Do Not Purge**: whether the revision is protected from automatic removal.

The expanded list shows a few revisions at a time. Scroll within it to load more.

If you can only view the project, you see the revisions but not the **Action** and **Do Not Purge** columns, and you can't edit notes.

<!-- VERIFY: Revision Date is labelled GMT. Confirm the displayed time really is GMT and not the viewer's local time. -->

## Revert to an earlier version

1. Expand the drawing's row and find the revision you want. The preview helps.
2. Click **Revert to this version**.

The revision opens in the drawing editor. The saved drawing is not changed yet: save it (<kbd>Ctrl</kbd>+<kbd>S</kbd> or **File > Save (Ctrl + S)**) to make this version the current one. The save records a new revision, so the version you reverted from remains in the list.

If the drawing was renamed after the revision was made, reverting and saving also brings back the old name.

> [!WARNING]
> Opening this grid saves the open drawing, which records a revision of the version you are about to revert from. A save within a minute of that revision replaces it, even if it is marked **Do Not Purge**. After reverting, wait until the newest revision is more than a minute old before you save, so the version you reverted from is kept.

> [!TIP]
> Before reverting, add a note to the newest revision so you can find your way back to it.

<!-- VERIFY: does a reverted drawing count as modified, so paid plans auto-save it straight away? -->
<!-- VERIFY: confirm that saving a reverted revision restores the drawing name stored in that revision. -->

## Add notes to a revision

1. Expand the drawing's row.
2. Click **Edit** on the revision's row.
3. Type in **Notes - Editable**.
4. Click **Save**, or **Cancel** to discard the change.

Notes are a good place to record why a change was made, or to mark versions sent to a client or issued for construction.

<!-- VERIFY: row edit command labels (Edit / Save / Cancel) in the revisions detail grid. -->

## Keep a revision from being removed

Mark a revision **Do Not Purge** to keep it when the drawing goes over 64 revisions.

1. Click **Edit** on the revision's row.
2. Select **Do Not Purge**.
3. Click **Save**.

Protected revisions are kept until you delete them yourself. **Do Not Purge** doesn't stop a save made within the same minute from replacing the revision's contents (see [How revisions are recorded](#how-revisions-are-recorded)).

> [!NOTE]
> Change **Notes - Editable** and **Do Not Purge** in separate edits. If you change both at once, only the note is saved.

<!-- VERIFY: RevisionsAPIController.Put saves Notes OR NoDelete (else-if), so editing both in one row edit drops the Do Not Purge change. Confirm, or fix the controller and remove this note. -->
<!-- VERIFY: the Do Not Purge column is declared with "datatype" (lower-case), not "dataType". Does it render and edit as a check box? -->

## Delete a revision

Click **Delete this revision** (the trash icon) in the revision's **Action** column. The revision is removed straight away, with no confirmation, and can't be recovered. This works on protected revisions too.

## Plan and permission limits

- You need edit permission for the project to revert, delete, protect or add notes to revisions.
- On the Free plan, **Revert to this version** and **Delete this revision** show a message asking you to upgrade.
- Deleting a drawing also deletes its revisions. See [Deleting a drawing]({{< relref "drawings#deleting-a-drawing" >}}).
  <!-- VERIFY: same question as drawings.md; confirm revisions are removed with the drawing. -->
- Copying a project with **Save As** on the dashboard doesn't copy revisions. See [Save As]({{< relref "projects#save-as" >}}).