What This Tool Does
To bulk upload to Etsy using CSV, your file must not exceed 2,500 rows and must follow Etsy's exact column headers for variations. This free tool validates your CSV format before you upload it to Etsy, preventing temporary account locks.
How to Use It
- Export your inventory as a CSV UTF-8 file from Microsoft Excel, Google Sheets, or your inventory system.
- Drop your .csv file into the private browser validator or load our sample CSV.
- Inspect row-by-row diagnostics for title truncation (>140 chars), unescaped commas, currency symbols in prices, and tag counts (>13 tags).
- Correct flagged cells in your spreadsheet and import directly to Etsy Shop Manager or Vela with 0 errors.
Worked Example: Auditing a 50-Item Bulk CSV Upload for Shop Manager
You prepare a bulk CSV upload of 50 new print-on-demand listings and want to ensure Etsy Shop Manager does not reject the file.
| Header Verification | PASS (5/5) |
| Title Length Audit | 2 ERRORS |
| Tag Quotation Audit | 1 ERROR |
| Price Numeric Format | PASS |
Correcting the two long titles and adding quotes around the multi-tag field prevented Etsy from rejecting the entire 50-item file.
Common Mistakes to Avoid
- Including currency signs like "$" in the price column, which causes the Etsy bulk parser to reject the row.
- Saving the CSV in ANSI or Windows-1252 format instead of UTF-8, which corrupts accented characters and emojis.
- Failing to enclose descriptions containing commas inside double quotes, which shifts CSV table columns.
- Exceeding 140 characters in the Title column across bulk rows.
- Putting more than 13 tags or tags longer than 20 characters in the tags column.
Last Reviewed: October 2026. Note: For marketplace fee schedules and policies, always verify on Etsy CSV Upload Documentation.
Frequently Asked Questions
What is the max limit for Etsy CSV upload?
The maximum limit for an Etsy CSV bulk upload is 2,500 rows and up to 3 variation attributes per listing (e.g. Size, Color, Material). Exceeding these limits causes the upload to fail or trigger moderation errors.
Why is my Etsy CSV failing?
Etsy CSV uploads most commonly fail due to incorrect column headers, hidden non-UTF-8 characters, exceeding 20 characters in tags, or violating the 2,500-row and 3-variation caps.
What columns are strictly required in an Etsy listing CSV?
At minimum, an Etsy listing CSV must include valid headers for Title, Description, Price, Quantity, and Tags.
Why does Etsy say my CSV has an invalid number of columns?
This almost always happens when a product description contains commas without being wrapped in double quotes, causing Excel to interpret the comma as a new column.
What character encoding should I use for Etsy CSVs?
Always save your spreadsheet using "CSV UTF-8 (Comma delimited) (.csv)". This preserves symbols like accents, degrees, and measurement symbols without corruption.
How should multiple tags be formatted in a single CSV cell?
Separate each tag with a comma, and enclose the entire cell in double quotes (e.g. "ceramic mug, coffee cup, handmade gift").
Is my inventory CSV file uploaded to your server?
No. The file is read locally in your browser memory using client-side JavaScript. No inventory or pricing records leave your machine.
What is the maximum number of items I can bulk upload at once?
Etsy recommends keeping bulk CSV files under 100 items per batch to avoid browser timeouts during server-side processing.