This article guides merchants on how to upload multiple new items (up to 1,000) to their inventory using a CSV file, saving time and effort compared to manual entry.
Precondition
Before starting, ensure you have:
- A properly formatted CSV file using the platform’s template.
- Access to the Mass Upload feature in your merchant dashboard.
How to Upload Items in Bulk:
Step 1: Go to the Mass Upload Page
- Log in to your Merchant Portal.
- Navigate to: Mass Upload page.
Step 2: Create a Category Group CSV File
- To create a category group CSV file, click on Download CSV format button.
- On this page the merchant manages multiple category group CSV file by creating, editing or deleting.
- Click + Create New Group, name the CSV file format. Select the category or subcategory and the custom fields needed then save it to create the category group CSV file
Step 3: Download the CSV Format
- Find your category group.
- Click the Download CSV Format button (blue).
Step 4: Fill Out the CSV Template
- Open the downloaded CSV file.
- Prepare product details such as Item Name, Price, and Stock Quantity.
CSV Template Overview
The template includes columns for essential product details and optional custom fields. Below are the key columns:
| Column Name | Description | Required? |
| Category ID | Category where the item will be listed | Yes |
| Merchant ID | Your unique seller ID | Yes |
| Item Name | Name of the product | Yes |
| Image 1–5 | URLs of product images | Optional |
| Item Description | Short description of the product | Optional |
| SKU | Unique identifier for the item | Optional |
| Price | Item price | Yes |
| Stock Quantity | Available inventory | Yes |
| CF-Name1, CF-Name2, CF-Name3 | Custom fields for additional details | Optional |
Common Issues
- Missing required fields (e.g., Item Name, Price).
- Incorrect file format (.xls instead of .csv).
- Invalid image URLs. Must be publicly accessible.
Best Practices
- Keep SKUs unique.
- Test with a small batch before uploading your full inventory.
- Ensure custom fields match platform requirements.
Note:
-
- Stock Quantity - If the item has variants, leave this field blank or set it to 0 (blank defaults to 0).For unlimited stock, use the Stock Limited field instead.
- Stock Limited - Set to FALSE for unlimited stock. Set to TRUE if stock tracking applies.
- Custom field type Location, Image, PDF file are not supported.
Step 5: Upload Your CSV File
- Back in the Mass Upload page, click Select CSV.
- Select your completed CSV file.
- Click Upload.
Step 6: Review Upload Results
After the upload completes, the system will display:
✅ Successfully uploaded items
❌ Items that failed to upload (with error reasons)
Step 7: Check Your Inventory
For Merchants: Uploaded items will appear under your Inventory List.
- For Admins: Items will appear under the Item List page.
Step 8: View Upload History
- Go to the History tab.
See a log of uploads, including:
- Timestamp
- Number of items uploaded
Step 9: Undo an Upload (Optional)
If needed, you can undo an upload by clicking the Undo button in the History tab.
What Happens Next?
With bulk upload, merchants can efficiently manage large inventories without manual item creation. Upload logs and undo options provide transparency and control over your data.