> For the complete documentation index, see [llms.txt](https://docs.protoboard.xyz/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.protoboard.xyz/collaborate/edit-control.md).

# Edit control

How one-editor-at-a-time works on shared boards, and how to start editing, request, release and take control

## Goal

Work on shared boards without overwriting each other. One person edits a board at a time; everyone else views it read only.

## The status pill

The pill next to the board name shows your state. Click it for the actions.

| State                          | Meaning                                                                       |
| ------------------------------ | ----------------------------------------------------------------------------- |
| **Viewing**                    | You can look, but the board is read only. Fields show a hint to start editing |
| **Editing**                    | You hold control; your changes save                                           |
| ***Name*****&#x20;is editing** | Someone else holds control                                                    |
| **Reconnecting**               | Your connection dropped; Protoboard is getting control back                   |
| **Local work kept**            | Control was taken from you; your unsaved changes are still in this browser    |
| **Locked**                     | The board is over the Free private-board limit                                |

<figure><picture><source srcset="https://3535233690-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHc6ZGiGpKHrs578383AS%2Fuploads%2Fgit-blob-87cad8087159daa108ac3239aab3a4a604ed29d8%2Fedit-status-viewing-dark.png?alt=media" media="(prefers-color-scheme: dark)"><img src="https://3535233690-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHc6ZGiGpKHrs578383AS%2Fuploads%2Fgit-blob-405e238dfee6ae0b0a4d4ed36564e19e105591f3%2Fedit-status-viewing-light.png?alt=media" alt="The status menu in Viewing state with Start editing, Load latest board, Save my work as a copy and Manage board"></picture><figcaption><p>The Viewing menu.</p></figcaption></figure>

## Start editing

{% embed url="<https://cdn.protoboard.ai/docs/clip/edit-start?title=Start+editing>" %}
Start editing
{% endembed %}

[Animated GIF](https://cdn.protoboard.ai/docs/clips/edit-start-light.gif) · Steps:

1. Click the pill.
2. Choose **Start editing**.

You need Editor or Owner access. If nobody else is editing, you get control at once.

## Ask for control

{% embed url="<https://cdn.protoboard.ai/docs/clip/edit-request?title=Request+editing+control>" %}
Request editing control
{% endembed %}

[Animated GIF](https://cdn.protoboard.ai/docs/clips/edit-request-light.gif) · Steps:

1. Click the pill while someone else is editing.
2. Choose **Request control**. You see "Control requested."

The editor sees "*name* requested editing control." with a **Save and release** button.

## Release control

{% embed url="<https://cdn.protoboard.ai/docs/clip/edit-release?title=Save+and+release+control>" %}
Save and release control
{% endembed %}

[Animated GIF](https://cdn.protoboard.ai/docs/clips/edit-release-light.gif) · Steps:

1. Click **Save and release** in the request notice, or open the pill and choose **Save and release control**.

Your changes save and the board becomes available. The other person then clicks **Start editing**; control isn't handed over automatically. Control is also released when you close the tab or leave the board. If the tab closes with unsaved changes, or the browser quits unexpectedly, control is released within about 30 seconds.

## Editing in another tab

If you already hold editing control in another tab or window, the status reads **In another tab**. Open it and choose **Edit here** to move control to this tab. The other tab keeps its local work. Reloading a tab you are editing in keeps your control.

## Take control (owners)

{% embed url="<https://cdn.protoboard.ai/docs/clip/edit-take?title=Take+editing+control>" %}
Take editing control
{% endembed %}

[Animated GIF](https://cdn.protoboard.ai/docs/clips/edit-take-light.gif) · Steps:

1. Click the pill while someone else is editing.
2. Choose **Take control…**.
3. In **Take editing control?**, click **Take control**.

The current editor stops editing right away and keeps their local work.

<figure><picture><source srcset="https://3535233690-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHc6ZGiGpKHrs578383AS%2Fuploads%2Fgit-blob-8f91aef4e032751f93b5a36675787f8ff74e8bc0%2Ftake-control-dialog-dark.png?alt=media" media="(prefers-color-scheme: dark)"><img src="https://3535233690-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHc6ZGiGpKHrs578383AS%2Fuploads%2Fgit-blob-87c7989f1cf7bfd88a426217dc60ad313b25e62f%2Ftake-control-dialog-light.png?alt=media" alt="The Take editing control? dialog explaining that the current editor will stop editing and keep their local work, with Cancel and Take control buttons"></picture><figcaption><p>Taking control.</p></figcaption></figure>

## If your control was taken

The pill shows **Local work kept**: "Your local changes have not replaced the shared board." Choose:

* **Save my work as a copy** to keep your changes as a separate board, or
* **Load latest board** to discard them and load the shared version.

## Common failures

<details>

<summary>I own the board but it says Viewing</summary>

Owners also view by default on shared boards. Click **Start editing**.

</details>

<details>

<summary>Start editing isn't offered</summary>

You're a Viewer, or someone else is editing. Ask an owner for Editor access, or use **Request control**.

</details>

## Related pages

* [Roles and access](https://docs.protoboard.xyz/collaborate/roles-and-access.md)
* [Saving, drafts and recovery](https://docs.protoboard.xyz/organize/saving-and-drafts.md)
* [Share a project with your team](https://docs.protoboard.xyz/tutorials/share-a-project.md)
