> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.simplyprint.io/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# How to import your filament inventory into SimplyPrint

# How to import your filament inventory into SimplyPrint

SimplyPrint's Filament Manager lets you import your entire filament spool inventory from other apps and services — or from any CSV or JSON file. This guide covers how importing works, what formats are supported, and how to get your spools into SimplyPrint.

## Supported formats

SimplyPrint auto-detects exports from these apps and services:

- **[Spool Buddy](https://help.simplyprint.io/en/article/how-to-export-your-filament-spools-from-spool-buddy-import-into-simplyprint-jv87v9/)** — CSV export from the iOS/Mac app
- **[Spoolman](https://help.simplyprint.io/en/article/how-to-export-your-filament-spools-from-spoolman-import-into-simplyprint-e61m3y/)** — JSON (via export script) or SQLite .db file
- **[SpoolManager (OctoPrint)](https://help.simplyprint.io/en/article/how-to-export-your-filament-spools-from-spoolmanager-octoprint-import-into-simplyprint-1xovx4v/)** — CSV or .db export from the OctoPrint plugin
- **[OctoPrint Filament Manager](https://help.simplyprint.io/en/article/how-to-export-your-filament-spools-from-octoprint-filament-manager-import-into-simplyprint-16abn56/)** — ZIP export from the OctoPrint plugin
- **[Spoolstock](https://help.simplyprint.io/en/article/how-to-export-your-filament-spools-from-spoolstock-import-into-simplyprint-qbav01/)** — CSV export from the mobile app
- **[3D Filament Profiles (SpoolDB)](https://help.simplyprint.io/en/article/how-to-import-from-3d-filament-profiles-spooldb-871h7g/)** — CSV or JSON export
- **SimplyPrint** — Re-import a previously exported SimplyPrint CSV
- **Custom** — Any CSV or JSON file with manual column mapping

When you upload a file, SimplyPrint detects the format automatically, maps the columns for you, and shows a preview before importing anything.

## How to import

To start an import, go to the **Filament Manager** and click the dropdown arrow next to the **Add** button, then select **Import filament**.

![Click the dropdown arrow next to Add, then select Import filament](https://storage.crisp.chat/users/helpdesk/website/-/f/f/2/2/ff22a914001c1000/hub-add-dropdown-import_163x0c8.png)

If your Filament Manager is empty, you'll also see an **Import** button in the toolbar and an **Import spools** button on the welcome screen.

![The empty Filament Manager shows an Import button in the toolbar and an Import spools button on the welcome screen](https://storage.crisp.chat/users/helpdesk/website/-/f/f/2/2/ff22a914001c1000/main-import-guide-empty-state-_h74g2r.png)

## Importing from any CSV or JSON

Even if the filament manager or app you use is not on the list above — or you have a custom spreadsheet — you can still import it. SimplyPrint supports **any CSV or JSON file**. You just map the columns from your file to SimplyPrint fields manually using the column mapper.

1. Click **Import filament** from the Add dropdown
2. Upload your CSV or JSON file
3. If the format is not auto-detected, you'll see the **column mapper** where you assign each column from your file to a SimplyPrint field

![The column mapper lets you manually assign source columns to SimplyPrint fields](https://storage.crisp.chat/users/helpdesk/website/-/f/f/2/2/ff22a914001c1000/hub-mapper_1drxs7w.png)

4. Map at minimum a **material type** (e.g. PLA, PETG) — other fields like brand, color, and weight are optional but recommended
5. Click **Preview** to see how your spools will be imported
6. Review the preview and click **Import**

## What can be imported

Each spool can include the following data:

| Field | Description |
| ----- | ----------- |
| Brand name | Matched against the Open Filament Database |
| Material type | PLA, PETG, ABS, TPU, etc. — matched to filament profiles |
| Material variant | Matte, Silk, CF, etc. |
| Color name & hex code | Color for visual display |
| Filament diameter | 1.75mm, 2.85mm, etc. |
| Total weight (grams) | Full spool weight |
| Remaining weight or percentage | How much is left |
| Location | Physical storage location |
| Cost / price | Purchase price |
| Purchase date & store | When and where it was bought |
| Notes | Custom notes |
| NFC ID | For NFC-tagged spools |

## Locations

If your imported spools have location data (e.g. "Shelf A", "Printer Room"), SimplyPrint can automatically create matching locations in your Filament Manager. During the preview step you'll see a checkbox to opt in or out of creating new locations. Locations that already exist by name are reused — no duplicates are created.

## Brand and material matching

SimplyPrint automatically matches imported brands and materials against the **Open Filament Database**. This means:

- Known brands (Bambu Lab, Prusament, eSun, etc.) get linked to their database entries
- Materials are matched to filament profiles with accurate temperature and density settings
- If a brand or material can't be matched, the spool is still created — it just won't have a linked database profile. You can assign one manually later.

## After importing

Once the import completes, your spools appear in the Filament Manager immediately. You can assign them to printers, track usage, and manage your inventory right away.