> 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/tutorials/share-a-project.md).

# Share a project with your team

Invite a teammate to a project with a role, accept the invitation, and take turns editing a board with edit control

## Goal

Share the Line-Following Robot project with a teammate as an **Editor**, have them accept, and hand editing control back and forth on the Main controller board. In this tutorial **Jordan** owns the project and **Sam** is the teammate.

{% hint style="info" %}
**Time:** 10 minutes. **You need:** two accounts (you and a teammate, or two browsers). The teammate must sign in with the email address you invite.
{% endhint %}

## Steps

{% stepper %}
{% step %}

### Invite the teammate (owner)

{% embed url="<https://cdn.protoboard.ai/docs/clip/share-invite?title=Invite+a+teammate+to+a+project>" %}
Invite a teammate to a project
{% endembed %}

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

1. Open the project page and click **Share project** (the people icon).
2. Type the teammate's email in **Invite email**.
3. Pick a role: **Viewer**, **Editor** (the default) or **Owner**.
4. Click **Create invitation**.

The dialog confirms "Invitation created" and lists the invite as pending, with **Copy invitation link** and a revoke button. Access applies to every board in the project, including boards added later. See [Roles and access](https://docs.protoboard.xyz/collaborate/roles-and-access.md).

<figure><picture><source srcset="https://3535233690-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHc6ZGiGpKHrs578383AS%2Fuploads%2Fgit-blob-05960ba95dd20e1e0a335d86819b242142858642%2Fshare-project-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-87f10138e971ee3421fd3caa196a307ef216011b%2Fshare-project-dialog-light.png?alt=media" alt="The Share project dialog with an invite email field, a role picker set to Editor, a Create invitation button and a pending invitation for a teammate"></picture><figcaption><p>The Share project dialog with a pending invitation.</p></figcaption></figure>
{% endstep %}

{% step %}

### Accept the invitation (teammate)

{% embed url="<https://cdn.protoboard.ai/docs/clip/invite-accept?title=Accept+a+project+invitation>" %}
Accept a project invitation
{% endembed %}

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

1. Open the email titled **Invitation to Line-Following Robot on Protoboard**.
2. Click **Accept invitation and open project**.
3. Sign in with the invited email address if you aren't already.
4. On **Boards shared with me**, the invitation is highlighted. Click **Accept invitation**.

The project now appears under **Projects shared with me** in the sidebar. Invitations expire after 30 days.

{% hint style="info" %}
Missed the email? Open **Boards shared with me** in the sidebar. Pending invitations are listed under **Invitations** with an **Accept** button.
{% endhint %}
{% endstep %}

{% step %}

### Start editing (teammate)

{% 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. Open the **Main controller** board. The status pill next to the board name says **Viewing**, and the board is read only.
2. Click the pill and choose **Start editing**.

If someone else is editing, the pill says "*name* is editing" and offers **Request control** instead.
{% endstep %}

{% step %}

### Ask for control back (owner)

{% 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. Jordan opens the board, clicks the pill and chooses **Request control**.
2. Sam sees a notice that Jordan requested editing control, with a **Save and release** button.

<figure><picture><source srcset="https://3535233690-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHc6ZGiGpKHrs578383AS%2Fuploads%2Fgit-blob-59216b58e5e39653f6b59e10cb256b8074c6f151%2Fedit-status-request-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-4325b123394f6e01ab2917dabf24e31f6d9e1583%2Fedit-status-request-light.png?alt=media" alt="The editing status menu on a board someone else is editing, showing who is editing and the Request control and Take control options"></picture><figcaption><p>Requesting control from the current editor.</p></figcaption></figure>
{% endstep %}

{% step %}

### Release control (teammate)

{% 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. Sam clicks **Save and release** in the notice, or opens the pill and chooses **Save and release control**.
2. Jordan clicks the pill and chooses **Start editing**. Control doesn't pass on automatically.
   {% endstep %}

{% step %}

### Take control when someone is away (owner only)

{% 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. Open the pill and choose **Take control…**.
2. In the **Take editing control?** dialog, click **Take control**.

The other person stops editing at once. Their unsaved changes stay in their browser, marked **Local work kept**, and they can **Save my work as a copy** or **Load latest board**.
{% endstep %}
{% endstepper %}

## Result

Your teammate has Editor access to every board in the project, and you know how to pass editing control between you. To share a single board instead, use the share icon in the editor header. See [Public, private and view links](https://docs.protoboard.xyz/collaborate/visibility-and-links.md).

## Common failures

<details>

<summary>The teammate doesn't see the invitation</summary>

They're signed in with a different email, or the email isn't verified. Invitations can only be accepted with the invited address. You can also send them the link from **Copy invitation link**.

</details>

<details>

<summary>The invitation has expired</summary>

Invitations last 30 days. Revoke the old one in **Share project** and create a new one.

</details>

<details>

<summary>My typing in Board Identity doesn't stick</summary>

The board is in **Viewing** mode, which is read only. Click **Start editing** first.

</details>

## Related pages

* [Roles and access](https://docs.protoboard.xyz/collaborate/roles-and-access.md): what Viewer, Editor and Owner can do
* [Invitations](https://docs.protoboard.xyz/collaborate/invitations.md): copy, revoke and accept invitations
* [Edit control](https://docs.protoboard.xyz/collaborate/edit-control.md): every editing state explained
* [Public, private and view links](https://docs.protoboard.xyz/collaborate/visibility-and-links.md): share without inviting
