Bulk Adding Items
Upload large amounts of inventory at once using CSV files to quickly populate or update your store.
Overview
Bulk adding items lets you upload many listings at once using a CSV file. This is the fastest way to populate your store or update large portions of your inventory.
Uploads are processed in the background after submission, so you can continue using your store while your inventory is being added.
You can access bulk uploads from either your store menu or your inventory page.
Accessing Bulk Uploads
There are two ways to open the bulk upload tool:
- Store Menu - Go to your store menu and select Bulk Item Upload
- Inventory Page - Go to Store Inventory > Create Listing > Bulk Item Upload
Uploading Your Inventory
- Open Bulk Upload - Use either access method above
- Upload File - Select your CSV file and click Next
- Review Upload - Check the summary of items to be added
- Confirm Upload - Click Add x Items to Store to start processing
CSV File Structure
Your CSV file must follow a specific format. Each row represents a single listing.
Required Columns
| Column | Description |
|---|---|
| price | Item price as a number (e.g. 19.99) |
| quantity | Number of items available, must be 0 or more |
| condition | Item condition, must match the accepted values below |
Item Identification
You must include at least one of the following for each row to identify the item being added:
| Column | Description |
|---|---|
| setId | LEGO set number, example 75192 |
| minifigureId | Minifigure ID, example fig-00001 |
| partId | Part ID, example 3001 |
| color | Color ID for parts, required when using partId |
If you are uploading parts, both partId and color must be included.
Optional Columns
| Column | Description |
|---|---|
| description | Notes visible to buyers |
| remarks | Internal notes for your own reference |
Condition Values
Condition values must match the item type.
Parts and Minifigures
| Condition | Description |
|---|---|
| new | Brand new item, may be sealed or unsealed |
| used | Previously owned item, may show signs of wear |
Sets
| Condition | Description |
|---|---|
| new-complete | Brand new and sealed |
| new-sealed | Opened but complete and in excellent condition |
| new-incomplete | Opened with missing pieces |
| used-complete | Used but complete |
| used-incomplete | Used with missing pieces |
Example CSV File
| setId | minifigureId | partId | color | quantity | price | condition | description | remarks |
|---|---|---|---|---|---|---|---|---|
| 75192 | 1 | 799.99 | new-sealed | Millennium Falcon sealed | Aisle 101 | |||
| fig-016601 | 2 | 4.99 | used | Commander Bly used figure | Aisle 102 | |||
| 3001 | 5 | 100 | 0.15 | new | 2x4 red brick brand new | Aisle 103 |
Common Issues
- Missing required fields - Ensure
price,quantity, andconditionare included - Invalid item identifiers - Include
setId,minifigureId, orpartIdwithcolor - Incorrect condition values - Use only supported values for the item type
- Formatting issues - Ensure CSV headers and values are properly structured
If a row does not match a valid item, it will not be added to your inventory.