How to Use eBay File Exchange — Complete Bulk Upload Guide (2025)
Learn how to download File Exchange templates, map your product columns, format bulk listings, handle variations, and troubleshoot upload errors — step by step.
Listing products one by one on eBay works fine when you have a dozen items. But when your catalog grows to hundreds or thousands of SKUs, the manual process becomes a bottleneck. eBay File Exchange lets you create, revise, and end listings in bulk via a CSV file — but the template has over 100 columns, category-specific requirements, and its own variation format. This guide covers everything you need to know to go from a product spreadsheet to live eBay listings.
What Is eBay File Exchange?
Overview & How It Works
eBay File Exchange is a bulk listing tool integrated into eBay Seller Hub. You download a CSV template, fill it with your product data, and upload it to create or update multiple listings simultaneously. The tool supports three actions: Add (create new listings), Revise (edit existing listings), and End (remove listings). File Exchange handles fixed-price and auction-style listings, multi-variation items, and item specifics — all from a single spreadsheet upload.
When to Use File Exchange vs. Single Listings
Use File Exchange any time you need to create more than 10 listings at once, update pricing or quantities across multiple items, or add item specifics in bulk. It's also the only practical way to set up multi-variation listings (like a shirt in multiple sizes and colors) without clicking through eBay's multi-step listing form for each variation. If you're listing fewer than 10 items, the single listing form may be faster — but for any volume beyond that, File Exchange saves significant time.
Step-by-Step: eBay File Exchange Bulk Upload
Four steps from a product spreadsheet to live eBay listings with correct categories, specifics, and variations.
Download the Template
In eBay Seller Hub, go to Listings > File Exchange and click "Download Templates." Select the "Add" template for creating new listings. The template downloads as a CSV file with over 100 column headers — don't panic. Most listings only need 15–25 of these columns filled.
The template includes a separate instructions sheet that explains every column, its accepted values, and whether it's required. Print or bookmark this reference — you'll need it. Pay special attention to the Category column, which requires eBay's numeric category ID (not the category name). You can find category IDs using eBay's Category Lookup tool.
If you plan to list variations (multi-size, multi-color), make sure you're using a category that supports them. Not all eBay categories allow variations — the instructions sheet indicates which ones do.
Map Your Columns
Your product data probably uses different column names than eBay's template. You need to map your columns to eBay's headers. Common mappings: your "Product Name" column becomes "Title", "Price" becomes "StartPrice", "SKU" becomes "CustomLabel", and "UPC" becomes "Product:EAN" or "Product:UPC".
The Action(SiteID) column must be set to "Add" for every new listing row. SiteID is a number representing your eBay marketplace — 0 for US, 3 for UK, 77 for Germany, etc. Every row needs this column filled, or the upload will fail entirely.
For item specifics (Brand, Color, Size, MPN, etc.), use the format "Specific:Brand", "Specific:Color", and so on as column headers. Each specific gets its own column. The exact specifics required depend on your category — check eBay's category-specific item specifics page for the mandatory fields.
Format Your Listings
Format matters. StartPrice must be a number with no currency symbol — "29.99" not "$29.99". Quantity is an integer. Duration is the listing length in days — typical values are "GTC" (Good 'Til Cancelled) or "30" for 30-day fixed price. The Category field needs the numeric category ID, not the name.
For multi-variation listings, the first row is the "parent" with Action set to "Add" and a Relationship value of "1". Subsequent variation rows have Relationship set to "1" as well, with VariationSpecifics like "Size=L" or "Color=Red" in the designated columns. Each variation row has its own SKU, price, and quantity.
Image URLs must be publicly accessible and use HTTPS. eBay downloads and hosts the images after upload. You can include up to 12 images per listing using the PicUrl column and additional image columns (AdditionalImageURL1 through AdditionalImageURL11).
Upload & Troubleshoot
Return to Listings > File Exchange in Seller Hub, click "Upload File," select your completed CSV, and submit. eBay starts processing immediately. For files under 500 rows, results typically appear within 10–30 minutes. Larger files can take up to several hours.
Once processing completes, download the Results File from the File Exchange page. This file mirrors your upload with an added "Result" column showing success or failure for each row. Failed rows include an error code and description — common issues include invalid category IDs, missing required specifics, and incorrectly formatted prices.
Fix only the failed rows in your original file and re-upload. Don't modify rows that succeeded, or you risk creating duplicate revisions. If you see a pattern of errors (like all rows missing the same specific), fix the column once and re-upload the entire file using the "Revise" action for the successful rows and "Add" for the corrected failures.
Alternative: Automate with AI
Skip the manual column mapping and formatting headaches. Upload your product CSV to ListingHubs and AI auto-detects your categories, maps every column to File Exchange format, structures variations, and generates a upload-ready file.
Frequently Asked Questions
What is eBay File Exchange?▼
eBay File Exchange is a bulk listing tool built into eBay Seller Hub that lets you upload multiple listings at once using a CSV spreadsheet. It supports creating new listings, revising existing ones, and ending listings — all from a single file. It's the fastest way to list dozens or hundreds of products on eBay without entering each one manually.
How do I download eBay File Exchange templates?▼
Sign in to eBay Seller Hub, go to Listings > File Exchange, and click 'Download Templates'. eBay provides several template types — the 'Add' template for new listings, 'Revise' for editing existing ones, and 'End' for removing listings. Download the 'Add' template for new listings. The template includes column headers that map to eBay's listing fields, and a separate instructions sheet explains each column.
Can I bulk list hundreds of products using File Exchange?▼
Yes. eBay File Exchange supports up to 25,000 rows per file for most categories, though processing time increases with file size. For best results, keep files under 5,000 rows and split larger inventories into multiple uploads. Each row represents one listing (or one variation row within a multi-variation listing).
How do I fix File Exchange upload errors?▼
After uploading, eBay generates a Results File that you can download from the File Exchange page. This file lists each row that failed with a specific error code and message — common issues include missing required columns, invalid category IDs, and price formatting errors. Fix the flagged rows in your original file and re-upload. Do not change rows that processed successfully.
What are the column limits in eBay File Exchange?▼
eBay File Exchange templates include over 100 columns, but most listings only need 15–25 of them. Required columns include Action(SiteID), ItemID, Category, Title, StartPrice, Quantity, and Duration. ConditionID is required for used items. Custom label (SKU), Item Specifics, and variation columns are optional but recommended for complete listings. Unused columns can be left blank.
Skip the manual File Exchange process
Upload your product CSV and get a File Exchange–ready file with mapped columns, formatted specifics, and structured variations — in minutes.
Get Started Free