> 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/editor/parts-bin.md).

# Parts Bin

Search and browse the ProtoPart library, add parts to your board, manage the templates on a board and request parts that are missing

## Goal

Find the parts you need, add them to your board, and manage the part templates the board already uses.

## Open the Parts Bin

Click **Parts Bin** (the cuboid icon) in the left rail. The panel is titled **Manage Parts** and has two tabs:

* **Library**: the ProtoPart library, searchable and browsable by category.
* **In Project**: the part templates already on this board.

<figure><picture><source srcset="https://3535233690-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHc6ZGiGpKHrs578383AS%2Fuploads%2Fgit-blob-4908723ea47f34c94d24f1dcba01b8a5bfb38957%2Fparts-bin-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-56302a589550f10b03d187dc3d486dd879a41979%2Fparts-bin-light.png?alt=media" alt="The Parts Bin panel titled Manage Parts with Library and In Project tabs, a search field, category and sort controls, and part cards with Add buttons"></picture><figcaption><p>The Parts Bin.</p></figcaption></figure>

## Find a part

{% embed url="<https://cdn.protoboard.ai/docs/clip/parts-search-add?title=Add+a+part+from+the+Parts+Bin>" %}
Add a part from the Parts Bin
{% endembed %}

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

1. Type in **Search Parts...**. Search understands descriptions as well as names, so `3.3V I2C temperature sensor` works as well as `BME280`.
2. Narrow the results with **Category** (microcontrollers, sensors, actuators, power, connectivity, robotics, mechanical, connectors, expansion, components and kits). Use **Back to parent category** to step out.
3. Change the order with the sort menu: **Relevance** or **Alphabetical (A–Z)**.
4. Click **Add** on a card. Scroll down and click **Load more parts** for more results.

Keyboard users can jump past the results with **Skip parts list**.

<figure><picture><source srcset="https://3535233690-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHc6ZGiGpKHrs578383AS%2Fuploads%2Fgit-blob-f689ccba2d7d54f832542bb767aacc83bf28bcb0%2Fparts-bin-categories-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-c5f5536aef8bd8c9d825dfa4cc668e5518feedc0%2Fparts-bin-categories-light.png?alt=media" alt="The Category menu open, showing the library category tree from Microcontrollers to Kits"></picture><figcaption><p>Browse by category.</p></figcaption></figure>

## What a part card shows

Each card shows the part's name, image, short description and a status badge. Press the badge to see what it means: **Blank**, **Unvalidated**, **Validated** or **Official**. See [Part status](https://docs.protoboard.xyz/parts/part-status.md). Buttons on the card open the vendor page and the datasheet when the part has them. The **⋮** menu has **Export Part**, which downloads the part definition.

## Parts that aren't in the library

1. Under the search results, click **Can't find it? Request a part**, or use the **Request a part** button in the panel header.
2. Fill in the form and click **Send request**. See [Request or fix a part](https://docs.protoboard.xyz/parts/request-or-fix-a-part.md).

To keep designing in the meantime, click **Add Blank Part** in the panel header (or the canvas toolbar) and define the part yourself. See [Edit part templates](https://docs.protoboard.xyz/parts/edit-part-templates.md).

<figure><picture><source srcset="https://3535233690-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHc6ZGiGpKHrs578383AS%2Fuploads%2Fgit-blob-3183ef1aaa5d1f001f7dc753047f787d05ac6f1a%2Fparts-bin-no-match-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-02d7f9ab8f2d48e4ddcfec36981aec9077814f5e%2Fparts-bin-no-match-light.png?alt=media" alt="A Parts Bin search with weak matches and the banner Can&#x27;t find it? Request a part under the results"></picture><figcaption><p>The request link under weak results.</p></figcaption></figure>

## Templates on this board (In Project)

The **In Project** tab lists each template the board uses. Each one's **⋮** menu offers:

| Item                                | What it does                                                             |
| ----------------------------------- | ------------------------------------------------------------------------ |
| **Edit Template**                   | Edit the template's ProtoPart JSON                                       |
| **Duplicate Template**              | Make an independent copy to change without affecting the original        |
| **Delete Template**                 | Remove the template; the dialog lists the parts that use it              |
| **Download Template**               | Save the template as a file                                              |
| **Report a problem with this part** | Tell the library team about wrong specs or missing files (library parts) |

The header buttons **Refresh Parts** and **Check remote status** compare your board's templates with the library, and **Import Part** loads a part definition file from your computer.

## Common failures

<details>

<summary>Search returns unrelated parts</summary>

The library may not have the part. Try the manufacturer part number, then request it with **Can't find it? Request a part**.

</details>

<details>

<summary>Add is greyed out</summary>

You're viewing the board without editing control. Click the status pill and choose **Start editing**.

</details>

## Related pages

* [Part status](https://docs.protoboard.xyz/parts/part-status.md): what the status badges mean
* [Edit part templates](https://docs.protoboard.xyz/parts/edit-part-templates.md): blank parts and template JSON
* [Request or fix a part](https://docs.protoboard.xyz/parts/request-or-fix-a-part.md): ask the library team
* [Inspector](https://docs.protoboard.xyz/editor/inspector.md): configure a part after you add it
