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


# Drawings and the Start Page

A project holds any number of drawings. The Start Page is where you see them, create new ones, and open, rename, copy, move or delete them. This page also covers saving, Save As, and recovering a drawing whose save didn't reach the server.

## The Start Page

When you open a project from the [Projects Dashboard]({{< relref "projects" >}}), it opens on the Start Page. To come back to it from a drawing, do any of these:

- Click the Simple Wires logo at the top left.
- Click the menu icon next to the logo.
- Choose **View > Start Page**.
- Click **Start Page** at the top of the left pane.

{{< screenshot name="drawings-start-page" alt="The Start Page with the Project Drawings list on the left and Tutorials and FAQs on the right" >}}

The top of the page shows **Current Project** and the project name. If you can only view the project, **[View Only]** follows the name. If you are on a team, your **User Role** is shown too.

The page has three parts:

- **Project Drawings**: the project's drawings in name order.
- **Tutorials**: short videos.
- **FAQs**: answers to common questions.

## The Project Drawings list

Each drawing shows its name, description, **Created** and **Modified** dates, and a preview of the drawing as it was last saved. The buttons beside each drawing are:

| Button | What it does |
|---|---|
| **Open this drawing** (folder) | Opens the drawing in the editor |
| **Rename this drawing** (pencil) | Changes the name and description |
| **Copy this drawing to another project** | Puts a copy in another project |
| **Move this drawing to another project** (suitcase) | Moves the drawing to another project |
| **Delete this drawing** (trash) | Deletes the drawing |

Only **Open this drawing** is shown if you can only view the project. The Free plan shows only **Open this drawing** too.

The buttons in the **Project Drawings** heading are **Add a New Drawing** (**+**) and **Refresh this list**. Use **Refresh this list** to pick up drawings that other people have added.

> [!NOTE]
> The Free plan allows one drawing per project. If a project has more, the Start Page shows only the first and displays a message asking you to upgrade.

## Creating a drawing

1. On the Start Page, click **Add a New Drawing** (**+**). In the editor, choose **File > New ...**.
2. In **New Drawing Name**, enter a name and click **Next**.
3. Enter a description (optional) and click **Next**.

The drawing is saved and opens in the editor.

On the Free plan a project can hold only one drawing, so creating a second drawing is refused with a message. Open the existing drawing instead.

{{< screenshot name="drawings-new-drawing" alt="The New Drawing Name dialog" >}}

Drawing names must be unique within the project and can't contain these characters: `. ' / \ % ? & * + < > : ;`

A new drawing takes its page size, margins, and stroke and fill settings from your [new drawing settings]({{< relref "projects#new-drawing-settings" >}}). Its text style and cable behavior come from the current editor settings. To change them for one drawing, see [Page Setup and Drawing Settings]({{< relref "page-setup" >}}).

If the drawing you have open has unsaved changes, Simple Wires asks **Save Your Work?** first. Click **Yes** to save it before creating the new drawing.

<!-- VERIFY: clicking No in the Save Your Work? prompt appears to cancel File > New entirely rather than continue without saving. Confirm. -->

## Opening a drawing

On the Start Page, click the drawing's name or preview, or click **Open this drawing**. From inside the editor, choose **File > Open** and pick the drawing from the list.

The title bar shows the project and drawing name.

When you open a drawing saved by a much older version of Simple Wires, you may be asked to **Switch Drawing Version**. Click **Switch** to update the drawing; blocks may change position. Click **Leave it alone** to open it unchanged.

> [!WARNING]
> Opening another drawing doesn't ask you to save the one you are leaving. Save first, especially on the Free plan, where drawings aren't saved automatically.

<!-- VERIFY: confirm unsaved changes are lost without a prompt when opening another drawing on the Free plan. -->

## Saving a drawing

Press <kbd>Ctrl</kbd>+<kbd>S</kbd>, or choose **File > Save (Ctrl + S)**. While the save is in progress the title bar shows **Saving changes...**, and a short message confirms when it is done.

On paid plans, Simple Wires saves automatically about three seconds after you stop making changes. Opening one of the **Project Data** grids also saves the drawing first.

Each save updates the preview on the Start Page and records a revision. See [Drawing Revisions]({{< relref "revisions" >}}).

If you can only view the project, **Save** isn't available.

## Save As

**File > Save As ...** saves the open drawing as a new drawing in the same project.

1. Choose **File > Save As ...**.
2. In **Save Drawing As**, enter the new name and click **Next**.
3. Enter the description and click **Next**.

The new drawing opens in the editor. The original stays as it was last saved.

Off sheet pointers in the new drawing that pointed back at the original drawing are updated to point at the new one, and so are pointers in other drawings of the project. See [Off Sheet Pointers]({{< relref "off-sheet-pointers" >}}).

On the Free plan, Save As is refused because it would add a second drawing to the project.

<!-- VERIFY: Save As rewires pointers in *other* drawings from the original to the copy. Is that the intended behavior users should expect? -->

## Renaming a drawing

1. On the Start Page, click **Rename this drawing**. In the editor, choose **File > Rename ...**.
2. In **Drawing Name**, enter the new name and click **Next**.
3. Change the description if you want, and click **Next**.

The same naming rules apply as for a new drawing.

<!-- VERIFY: can you keep the same name and change only the description? The name check may report "That name already exists in this project". -->

## Copying or moving a drawing to another project

You can copy or move a drawing into another project that you can edit. This isn't available on the Free plan.

1. On the Start Page, click **Copy this drawing to another project** or **Move this drawing to another project**.
2. In **Select a Project**, choose the destination project. Projects you can only view are marked **VIEW ONLY!** and can't be used.
3. Click **OK**.

{{< screenshot name="drawings-copy-move" alt="The Select a Project dialog listing the user's projects" >}}

A copy is a new drawing in the other project, with today's date as its created date. A moved drawing is removed from this project.

You can't copy or move a drawing into the project it is already in. To duplicate a drawing within a project, open it and use **File > Save As ...**.

<!-- VERIFY: button label in the Select a Project dialog (OK?). -->
<!-- VERIFY: are a drawing's revisions kept when it is moved, and are they copied when it is copied? Is a duplicate name in the destination project allowed? What happens to off sheet pointers that refer to drawings left behind? -->

## Deleting a drawing

1. On the Start Page, click **Delete this drawing**. In the editor, choose **File > Delete**.
2. Click **Yes, delete it!** to confirm.

> [!WARNING]
> A deleted drawing can't be recovered, and its revisions go with it.

<!-- VERIFY: confirm a drawing's revisions are deleted along with the drawing. -->

## Recovering a drawing

Before each save, Simple Wires keeps a copy of the drawing in your web browser. If the save reaches the server, the copy is removed. If it doesn't, for example because your internet connection dropped, you see the message "Drawing failed to save. We have created a backup locally." and the copy stays.

The next time you open that drawing in the same browser, the **Recover Drawing** dialog appears. The server's copy is loaded in the editor behind the dialog, and the copy kept in your browser is shown in **Preview**.

{{< screenshot name="drawings-recover" alt="The Recover Drawing dialog with the local copy in the Preview panel" >}}

Choose one of:

- **Recover Drawing**: loads the browser's copy into the editor and removes it from the browser. Save the drawing to store it on the server.
- **Discard Recovered Drawing**: removes the browser's copy and keeps the server version. This can't be undone.
- **Do Nothing, I Need More Information**: closes the dialog and keeps the browser's copy. Look around the server version, then reopen the drawing to see the dialog again. The copy is replaced the next time you save this drawing.

The copy lives only in the browser on the computer where the save failed. Opening the drawing on another computer or in another browser won't offer it.

<!-- VERIFY: after Recover Drawing, is the recovered drawing marked as modified (so paid plans auto-save it), or must the user save manually? -->

## Tutorials and FAQs

The **Tutorials** panel lists short videos. Click the play button on a row to watch it:

- **Intro**: a quick introduction to Simple Wires.
- **Block Diagrams**: getting started with block diagrams.
- **Interface Basics**: a tour of the user interface.
- **Drawing Revisions**: how Simple Wires keeps your changes and how to go back to an earlier version.

The **FAQs** panel answers common questions. Click a question to expand it:

- How do I add equipment to the drawing?
- How do I draw a cable?
- I dropped equipment in a rack and it stuck. How do I unstick it?
- When does the watermark go away?
- Why aren't my wires sticking when I move a block?
- Why are my rack panels not populating in my bill of materials?
- I have a Paid subscription. Can I share a project with a Free subscription?

For more answers, see [FAQ and Troubleshooting]({{< relref "faq" >}}).