> 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/validate-and-build/bill-of-materials.md).

# Bill of materials and suppliers

Review your board's bill of materials, fetch prices, manage suppliers, mark owned parts and export the BOM as CSV or PDF

## Goal

Get an accurate parts list with prices and suppliers for your board, ready to order or share.

Open **Bill of Materials** (the cart icon) in the left rail. The panel is marked **Alpha**.

<figure><picture><source srcset="https://3535233690-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHc6ZGiGpKHrs578383AS%2Fuploads%2Fgit-blob-27a6ab20957842d1ef0a2c5372e2ca685515bee3%2Fbom-panel-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-dacd0fa4d94e3687b124921acff0e88df51be88a%2Fbom-panel-light.png?alt=media" alt="The Bill of Materials panel with summary cards and the parts table"></picture><figcaption><p>The Bill of Materials.</p></figcaption></figure>

## Summary

| Card                        | Shows                                                                                                                       |
| --------------------------- | --------------------------------------------------------------------------------------------------------------------------- |
| **Total Parts**, **Unique** | How many parts, and how many different ones                                                                                 |
| **Suppliers**, **In Stock** | How many suppliers are used, and how many parts are in stock                                                                |
| **Estimated Cost**          | The total from active supplier prices. "Prices may vary. Tax and shipping not included."                                    |
| **Build & Ship**            | Request a build quote. See [Request a build quote](https://docs.protoboard.xyz/validate-and-build/request-a-build-quote.md) |

## Fetch prices

{% embed url="<https://cdn.protoboard.ai/docs/clip/bom-fetch-prices?title=Fetch+BOM+prices>" %}
Fetch BOM prices
{% endembed %}

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

1. Click **Fetch Prices** on the **Estimated Cost** card.
2. Read the **BOM Price Update Review**: items **Checked**, **Fresh** and **Needs research**, with each item's price state (**Fresh**, **Outdated price** or **Missing price**).
3. Optionally send items that need research to ProtoBot. This uses Energy.
4. Close the dialog.

## The parts table

Columns: **NAME**, **PART #**, **PART TYPE**, **CATEGORY**, **SUPPLIER**, **PRICE** and **TOTAL**. Use **Toggle Columns** to show or hide columns, and **Open fullscreen** for a larger view.

Each row's **⋮** menu has:

| Item                                    | What it does                                           |
| --------------------------------------- | ------------------------------------------------------ |
| **Auto Update**                         | Refresh this item's price                              |
| **Mark as Owned** / **Unmark as Owned** | Exclude parts you already have from what to buy        |
| **Add Supplier** / **Edit Supplier**    | Add or change a supplier record                        |
| **Mark Price Reviewed**                 | Record that you checked the price, without changing it |

<figure><picture><source srcset="https://3535233690-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHc6ZGiGpKHrs578383AS%2Fuploads%2Fgit-blob-859302b07ff2b9d464ae8a91ce52660b933c0ddf%2Fbom-row-actions-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-ca0423d52df0e5711e4b09f5d884561c6cf198a8%2Fbom-row-actions-light.png?alt=media" alt="A BOM row&#x27;s menu with Auto Update, Mark as Owned, Edit Supplier and Mark Price Reviewed"></picture><figcaption><p>Row actions.</p></figcaption></figure>

Changing a row's quantity adds or removes parts on the board, so Protoboard asks you to confirm.

## Suppliers

{% embed url="<https://cdn.protoboard.ai/docs/clip/bom-supplier?title=Choose+a+supplier>" %}
Choose a supplier
{% endembed %}

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

1. Open the **Supplier** dropdown in a row. Each supplier shows its price.
2. Pick one to make it the active supplier. The total updates.
3. Choose **Add New Supplier** to add one: **Vendor** (Amazon, Digi-Key, Mouser, Adafruit, SparkFun or Other), **Purchase Link**, **Total Price**, **Parts per Pack**, and optionally **Vendor Part ID**, **Availability** and **Affiliate Link**.

Supplier records belong to the board.

## Export

Click **Export BOM** and choose **Export CSV** or **Export PDF**. The PDF includes the summary and clickable purchase links.

## Common failures

<details>

<summary>Buttons are greyed out</summary>

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

</details>

<details>

<summary>A price looks wrong</summary>

Open **Edit Supplier**, check the purchase link and **Parts per Pack** (a pack of 10 at $5 is $0.50 per part), and correct it.

</details>

## Related pages

* [Price, export and order your BOM](https://docs.protoboard.xyz/tutorials/price-and-order-your-bom.md)
* [Request a build quote](https://docs.protoboard.xyz/validate-and-build/request-a-build-quote.md)
* [Energy and usage](https://docs.protoboard.xyz/protobot/usage-and-energy.md)
