Evoke
EGT Token

Bulk Product Upload Documentation

This guide provides step-by-step instructions for uploading multiple products using CSV or ZIP files. Follow the guidelines to prepare your files and avoid common errors. Images in ZIP uploads are automatically uploaded to Amazon S3 and mapped to your products.

1. Download Sample CSV

Download our sample CSV to use as a template for your product data. It includes all supported columns and example data for two products.

2. CSV Upload

Upload a CSV file containing product details. For CSV uploads, images must be hosted externally (e.g., public URLs) and referenced in the ImagePaths or PhotosAndVideos columns.

  • File Format: CSV with a header row and at least one data row.
  • Required Column: ProductName (other fields are optional).
  • Image Columns: Use image_main for the primary image, ImagePaths for additional images (comma-separated URLs),
  • Quoting Fields: Wrap fields containing commas (e.g., PageBuilder_1_DescriptionOne) in double quotes to prevent parsing errors.
  • Supported Columns:

    • ProductName
    • ProductDescription
    • ProductSKU
    • ProductStockQuantity
    • PriceInUSD
    • PriceInETH
    • CategoryID
    • BrandName
    • WholesalePrice
    • WarrantyPeriod
    • RewardTokenRedeemPercentage
    • Primary3DUrl
    • Seo.Tags
    • Seo.MetaTitle
    • Seo.Description
    • IsReturnsAccepted
    • IsExchangesAccepted
    • MaxDaystoReturn
    • image_main
    • image_left
    • ImagePaths
    • ProductNFTImage
    • ProductCOAImage
    • Attribute_X_CategoryID, Attribute_X_CategoryAttributeID, Attribute_X_CategoryAttributeValues, Attribute_X_ProductAttributesID (X = 1, 2, ...)
    • PageBuilder_X_PageBuilderStructureTypeID, PageBuilder_X_HeaderTextOne, PageBuilder_X_DescriptionOne, PageBuilder_X_ShowBuy, PageBuilder_X_ShowConnectWallet (X = 1, 2, ...)
    • Shipping Services: USPSPriorityMailExpress, USPSPriorityMail, USPSFirstClassMail, USPSPriorityMailInternational, USPSPriorityMailExpressInternational, StandardInternational, USPSMediaMail, USPSParcelSelectGround
    • Shipping Options: ShippingOptionData.ShippingOptionID, ShippingOptionData.ProductID, ShippingOptionData.CategoryID, ShippingOptionData.OriginZipCode, ShippingOptionData.ShippingPricesCalcAutoOrManual, ShippingOptionData.ProcessingTimeDuration, ShippingOptionData.CanShipTo, ShippingOptionData.HandlingFee, ShippingOptionData.ProfileName, ShippingOptionData.FreeDomesticShipping, ShippingOptionData.SaveShippingProfile
  • Data Types:
    • Numbers: Parsed automatically (e.g., ProductStockQuantity, PriceInUSD). Invalid numbers cause row-specific errors.
    • Booleans: Accepts "true", "1", "yes" for true; "false", "0", "no" for false.
    • Strings with Commas: Must be quoted (e.g., "2, powerful gpu, latest and best gpu now").

Example CSV:

ProductName,ProductSKU,PriceInUSD,CategoryID,image_main,Attribute_1_CategoryID,Attribute_1_CategoryAttributeID,Attribute_1_CategoryAttributeValues,Attribute_1_ProductAttributesID,Attribute_2_CategoryID,Attribute_2_CategoryAttributeID,Attribute_2_CategoryAttributeValues,Attribute_2_ProductAttributesID,PageBuilder_1_PageBuilderStructureTypeID,PageBuilder_1_HeaderTextOne,PageBuilder_1_DescriptionOne,PageBuilder_1_ShowBuy,PageBuilder_1_ShowConnectWallet
Smartwatch,SKU101SM,199.99,103,https://example.com/image1.jpg,103,201,Black,1002353245,103,202,Medium,100435,1,Smartwatch Header,"Fitness tracking, heart rate, and notifications",TRUE,FALSE
GPU,SKU101GP,350.00,103,https://example.com/image2.jpg

3. ZIP Upload

Upload a ZIP file containing a products/data.csv file and an assets/ folder with images. Images are automatically uploaded to Amazon S3 and mapped to your products using the provided paths.

Download our sample ZIP to use as a template for your product data. It includes all supported columns in csv and example photos data and folder structure for two products.

  • ZIP Structure:
    • products/data.csv
    • products/assets/MPImages/ (for image_main, image_left, ImagePaths)
    • products/assets/COA/ (for ProductCOAImage)
    • products/assets/NFT/ (for ProductNFTImage)
  • Image Paths in CSV: Use relative paths (e.g., assets/MPImages/image1.jpg).
  • Image Columns:
    • image_main: Primary image (recommended for initial upload).
    • image_left, ImagePaths: Additional images (add later via UI to simplify).
    • ProductNFTImage, ProductCOAImage: Single paths for NFT and COA images.
  • Image Uploaded in our system: Images are uploaded to YourVendorID/products/ with timestamps.
  • Supported Image Formats: JPEG, PNG. Ensure correct file extensions.

Example ZIP Structure:

my_products.zip
├── products/
│   ├── data.csv
│   └── assets/
│       ├── MPImages/
│       │   ├── image1.jpg
│       │   ├── image2.jpg
│       ├── COA/
│       │   ├── coa_image1.jpg
│       │   ├── coa_image2.jpg
│       └── NFT/
│           ├── nft_image1.jpg
│           ├── nft_image2.jpg

Example data.csv for ZIP Upload:

ProductName,ProductDescription,ProductSKU,ProductStockQuantity,PriceInUSD,PriceInETH,CategoryID,BrandName,WholesalePrice,WarrantyPeriod,RewardTokenRedeemPercentage,Primary3DUrl,Seo.Tags,Seo.MetaTitle,Seo.Description,IsReturnsAccepted,IsExchangesAccepted,MaxDaystoReturn,image_main,ProductNFTImage,ProductCOAImage,ImagePaths,image_left,Attribute_1_CategoryID,Attribute_1_CategoryAttributeID,Attribute_1_CategoryAttributeValues,Attribute_1_ProductAttributesID,Attribute_2_CategoryID,Attribute_2_CategoryAttributeID,Attribute_2_CategoryAttributeValues,Attribute_2_ProductAttributesID,PageBuilder_1_PageBuilderStructureTypeID,PageBuilder_1_HeaderTextOne,PageBuilder_1_DescriptionOne,PageBuilder_1_ShowBuy,PageBuilder_1_ShowConnectWallet
Smartwatch,Fitness tracker with heart rate monitor,SKU101SM,10,199.99,,103,TechBrand,149.99,1 year,2.5,https://example.com/3dsmwatch,"wearable,smartwatch",Smartwatch Title,Advanced fitness tracking smartwatch,TRUE,FALSE,10,assets/MPImages/image1.jpg,assets/NFT/nft_image1.jpg,assets/COA/coa_image1.jpg,,,103,201,Black,1002353245,103,202,Medium,100435,1,Smartwatch Header,"Fitness tracking, heart rate, and notifications",TRUE,FALSE
GPU,Graphics processing unit,SKU101GP,10,350.00,,103,TechBrand,249.99,1 year,2.5,https://example.com/3dgpu,"gpu,graphics",GPU Title,High-performance graphics processing unit,TRUE,FALSE,10,assets/MPImages/image2.jpg,assets/NFT/nft_image2.jpg,assets/COA/coa_image2.jpg,,,103,203,High Performance,1009,,,1,GPU Header,"High-speed graphics, ideal for gaming and AI",TRUE,FALSE

4. Troubleshooting Tips

  • Error: "Image file not found"
    • Verify file paths in CSV match the ZIP structure (e.g., assets/MPImages/image2.jpg).
    • Check case-sensitivity and file extensions (JPEG/PNG).
    • Use browser dev tools (F12) to view detailed logs.
  • Error: "Failed to upload images to cloud in zip upload"
    • Contact support.
  • Error: "Row has X columns, expected Y"
    • Wrap fields with commas in double quotes (e.g., "2, powerful gpu, latest and best gpu now").
    • Ensure the CSV has exactly 35 columns (pad with commas for empty fields).
  • Error: "Invalid number for Attribute_X_ProductAttributesID"
    • Ensure Attribute_X_ProductAttributesID contains valid numbers or is empty.
    • Check for unquoted commas in fields like PageBuilder_1_DescriptionOne, which can shift values.
  • Vendor ID Issues: Ensure you’re logged in as a seller to auto-apply your Vendor ID.

5. Additional Notes

  • Vendor ID: Automatically applied if not specified in the CSV.
  • File Extensions: Use exact extensions in CSV (e.g., .jpg, not .jpeg) for ProductNFTImage and ProductCOAImage.
  • Debugging: Open browser dev console (F12) to view detailed upload logs, including parsed rows and image mappings.
  • Authentication: You must be logged in as a seller, or you’ll be redirected to the login page.
  • Editing Products: After uploading, edit products via the UI to add additional images or update attributes.