How to use the CSV uploader

Before you start

Your CSV uploader works best when your spreadsheet is tidy, consistent, and easy to scan. You do not need to make it perfect, but a little prep now saves a lot of review later.

1. Start with a clean file

Use one row per item. Keep the first row for column names, and make sure each column has one clear job.

Good examples:

• title
• description
• price
• brand
• condition
• image_url_1
• image_url_2
• image_url_3

If your export has extra columns you do not need, leave them out if you can. The simpler the file, the easier it is to upload.

2. Use plain, readable column names

The uploader is happiest when column names are obvious. If your export uses different names, that is fine. Just check that they still make sense to you before upload.

Helpful examples:

• item_name instead of name
• product_description instead of details
• main_image instead of photo

3. Keep each value in the right place

Try to keep one type of information in each column.

For example:

• Put the product title in one column.
• Put the price in one column.
• Put the condition in one column.
• Put each image URL in its own column.

If you mix too many things into one cell, the uploader has less to work with.

4. Add images the right way

If your file includes image URLs, give each image its own column instead of cramming them all into one cell.

Good pattern:

• image_url_1
• image_url_2
• image_url_3

That keeps the row readable and stops the upload from breaking.

Tip: use the best image you already have for each item. Clear, simple photos usually work best.

5. Check your prices and titles before uploading

This is the easiest way to avoid fixing lots of little mistakes later.

Before you upload, quickly scan for:

• missing prices
• duplicate titles
• random symbols in the wrong column
• empty rows in the middle of the file

6. Upload a sample first if you are unsure

If you are importing a large catalog, test with a small sample first. That way you can see how your columns are being understood before you upload everything.

What the uploader helps with

The CSV uploader is designed to do the heavy lifting for you.

It can help by:

• reading common spreadsheet formats
• understanding your columns
• matching the right data to the right listing fields
• helping you spot rows that need attention
• bringing in images where links are available
• saving you from manually creating every listing one by one

What you should still double-check

The uploader can move quickly, but it still helps to review a few things before publishing.

Please check:

• spelling in titles and descriptions
• the right price on each item
• the correct condition
• whether images show the right product
• whether any rows were skipped or marked for review

A simple upload flow

1. Prepare your CSV.
2. Make sure the first row has clear column names.
3. Check that each item has its own row.
4. Add image URLs in separate columns.
5. Upload a small sample if you want to test first.
6. Review the results.
7. Fix anything that looks off.
8. Upload the full file when you are happy.

Tips that save time

• Keep names short and consistent.
• Use the same formatting across the whole file.
• Remove blank rows before uploading.
• If you have many similar items, keep the structure the same for every row.
• If something looks wrong in the preview, fix the spreadsheet first instead of trying to force it later.

Common questions

Do I need to be perfect?

No. Clean and consistent is enough. The uploader is there to make the process easier, not harder.

Can I upload a huge catalog in one go?

Yes, but starting with a smaller batch is often the safest way to check that everything maps the way you expect.

What if my spreadsheet uses different column names?

That is okay. Just make sure you understand what each column means before uploading.

What if I only have some images?

You can still upload the file. Just put each image URL in its own column and leave the rest blank if you do not need them.

Final check before you hit upload

Ask yourself:

• Does every row represent one item?
• Are the column names clear?
• Are the prices correct?
• Do the images point to the right products?
• Have I removed anything messy or duplicate?

If the answer is yes, you are ready to go.