> 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/bring-in-an-existing-design.md).

# Bring in an existing design

Export a board to a .protoboard file and import a board file or pasted JSON, then save it to the cloud in a project

## Goal

Move a board between accounts, machines or backups using a `.protoboard` file. You'll export the Sensor test rig, import a board file as a draft, and save it to the cloud in your project.

{% hint style="info" %}
**Time:** 5 minutes. A `.protoboard` file is a complete copy of one board: parts, templates, harnesses, groups, notes, Board Identity and BOM. See [.protoboard file format](https://docs.protoboard.xyz/reference/protoboard-file-format.md).
{% endhint %}

## Steps

{% stepper %}
{% step %}

### Export a board

{% embed url="<https://cdn.protoboard.ai/docs/clip/export-board?title=Export+a+board+to+a+file>" %}
Export a board to a file
{% endembed %}

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

1. Open the board.
2. Click the Protoboard logo at the top left to open the **Project menu**.
3. Choose **Export to File**. Your browser saves `<board name>.protoboard`, or asks where to save it.
   {% endstep %}

{% step %}

### Import a board file

{% embed url="<https://cdn.protoboard.ai/docs/clip/import-board?title=Import+a+board+from+a+file>" %}
Import a board from a file
{% endembed %}

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

1. Open the **Project menu** (in the editor, or the logo menu on the dashboard) and choose **Import from File**.
2. In the **Import Board** dialog, click to browse for a `.protoboard` or `.json` file, or choose **Paste board JSON instead**, paste the JSON and click **Load JSON**.

The board opens as a **local draft**: it lives only in this browser until you save it. Imported boards get a new board ID, so they never overwrite the original.
{% endstep %}

{% step %}

### Save it to the cloud

1. Open the **Project menu** and choose **Save to Cloud**, or press **Ctrl+S**.
2. Choose a **Visibility** (Private or Public) and a **Project**, for example `Line-Following Robot`.
3. Confirm. The status pill changes from **Local draft** to **Saved**.

<figure><picture><source srcset="https://3535233690-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHc6ZGiGpKHrs578383AS%2Fuploads%2Fgit-blob-3021824197c15a2973ac0b31e651e0c9943f8cf3%2Fsave-to-cloud-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-cf6509db3e5392cf824e4fd268046b8247e98916%2Fsave-to-cloud-light.png?alt=media" alt="The Save to Cloud dialog with Visibility options Private and Public and a Project dropdown"></picture><figcaption><p>Save a draft to the cloud.</p></figcaption></figure>
{% endstep %}
{% endstepper %}

## Result

The imported design is a normal cloud board in your project. Rename it from Board Identity or the board card menu.

## Common failures

<details>

<summary>"Private board limit reached"</summary>

Free accounts have 2 private boards. Save it as **Public**, or free a private slot. See [Plans, limits and Energy](https://docs.protoboard.xyz/start-here/plans-limits-and-energy.md).

</details>

<details>

<summary>The file won't load</summary>

The file isn't a Protoboard board, or it was edited by hand and is no longer valid JSON. Export it again from the source board.

</details>

<details>

<summary>I closed the tab before saving the draft</summary>

Drafts stay in this browser. Open **My Boards** and look under **Drafts**, then use **Open & save to cloud**. See [Saving, drafts and recovery](https://docs.protoboard.xyz/organize/saving-and-drafts.md).

</details>

## Related pages

* [.protoboard file format](https://docs.protoboard.xyz/reference/protoboard-file-format.md): what the file contains
* [Saving, drafts and recovery](https://docs.protoboard.xyz/organize/saving-and-drafts.md): drafts, autosave and conflicts
* [Projects](https://docs.protoboard.xyz/organize/projects.md): file boards into projects
