← ListingGood
EN中文
ListingGood · Blog

Amazon Flat File Errors: How to Fix the 15 Most Common Upload Errors (2026)

Amazon Operations · Troubleshooting · 9 min read · September 2026

Sooner or later, every serious Amazon seller ends up in the flat file. The Seller Central forms are fine for five SKUs, but the moment you need to update prices across a seasonal catalog, fix a compliance attribute on forty products, or build out a variation family, a bulk upload is the only sane option. And the moment you try one, you meet the error report: a wall of codes like 8541, 8560, and 90220 that Amazon explains with roughly one sentence each.

The good news is that flat file errors are far less mysterious than they look. A small set of codes covers the overwhelming majority of failed uploads, and each one has a known cause and a known fix. This guide walks through the fifteen errors sellers run into most often, what each one actually means, and the exact change that clears it — plus a pre-upload checklist that prevents most of them from happening in the first place.

Why Amazon Flat Files Break So Often

A flat file is a template spreadsheet that Amazon converts into a feed behind the scenes. Every column maps to a product attribute, every row maps to a SKU, and the whole file must pass thousands of validation rules before a single change goes live. Errors happen when any of those rules disagree with your data.

Three structural quirks cause most of the pain:

Understanding that last point matters most: always read the Processing Report after every upload, even when the upload "succeeds". The report — found under Manage Your Feeds in Seller Central — is the only authoritative list of what actually changed.

The Golden Rule of Debugging Flat File Errors

Before the code-by-code breakdown, internalize one habit that saves hours: fix errors in a fresh copy of the current template, one error batch at a time, and re-upload.

Sellers who try to fix all forty errors in one pass usually introduce new ones (a cell format knocked off, a required column deleted). Small batches, fresh templates, re-upload. That loop is the whole game.

The 15 Most Common Amazon Flat File Errors — and the Fix That Works

Here is the quick-reference table, followed by notes on the errors that need more explanation.

#Code / MessageWhat It Actually MeansFix
18541 — SKU does not match the ASIN dataYour SKU matched an existing ASIN, but at least one key attribute (brand, barcode, condition, title) disagrees with Amazon's record.Match Amazon's existing values exactly for key attributes; only change fields you truly intend to update.
28560 — You cannot update this ASINAnother seller or brand owns the detail page and your data conflicts with it.Set only the fields you sell on (price, quantity, condition); leave title, images, and description untouched unless you own the brand.
38002 — You do not have permission to update this listingThe SKU is linked to another account, is brand-gated, or your file uses an account without listing rights.Verify you are on the right account and region; if the SKU belongs to a merged or closed account, resolve ownership in Seller Support.
490220 — Invalid or too long item nameTitle exceeds the category's character limit or contains forbidden characters (emoji, ™/®, HTML tags).Trim to the category limit, remove symbols and HTML, keep one brand mention.
590227 — Brand value not authorizedThe brand field contains a name your account is not approved to use (a typo counts).Use the brand exactly as enrolled or approved; fix typos; apply for approval if the brand is genuinely yours.
68005 — Main image missing or invalidThe main_image_url field is empty, the URL is not publicly reachable, or the image violates requirements.Use a direct, public, https image URL ending in the image file itself (no landing pages), on pure white for the main image.
78511 — Invalid pricePrice is blank, zero, negative, or formatted with currency symbols.Enter a plain number using a period as the decimal separator; currency is implied by the marketplace.
88008 — Invalid browse node / categoryThe recommended_browse_nodes value does not exist on this marketplace.Copy the node ID from the current template's valid-values tab or from Amazon's browse tree guide for that marketplace.
98580 — Sub-category does not matchAttribute values (often size or color) conflict with the category's defined valid values.Use only values from the template's valid-values list; match capitalization and spelling exactly.
108545 — Parent SKU does not existYou listed a child variation before uploading (or with a typo in) the parent SKU row.Include the parent row first in the same file, and make the parent_sku value character-for-character identical.
118007 — Invalid parentage / variation themeThe variation theme does not fit the category, or the child rows are missing the theme attributes.Pick a theme from the template's valid values and fill in the matching attribute columns (e.g., color_name for a color theme).
128568 — Internal application failureAmazon-side processing failed, often triggered by corrupted cells, hidden characters, or a partially wrong file format.Re-save as the exact required format, remove formatting and merged cells, retry once; if it persists, wait 30 minutes — it is frequently transient.
138115/8125 — Missing required fields (condition, price)Category-required columns are empty.Fill every required column for your category; check the template's headings for the tiny "required" markers.
14Barcode mismatch / GTIN errorThe UPC/EAN in the file does not match the GS1 record for the product, or check-digit is wrong.Verify the barcode against your GS1 certificate and re-enter it without spaces; use a GTIN exemption flow only if genuinely exempt.
15Category approval requiredThe target category is gated for your account.Apply for ungating through Add a Product first; do not force the flat file through — it will keep failing until approval lands.

The three errors that eat the most time

8541 is the classic. It usually appears when you try to create a SKU that already exists in a slightly different form — a trailing space in the SKU, or a title that differs by one word from what Amazon has. The fix is to treat it as a reconciliation problem: pull up what Amazon has, decide which fields you are genuinely changing, and make everything else identical. Do not fight Amazon's record on brand or barcode fields; those rows will lose.

8560 punishes sellers who treat the detail page as theirs when it is shared. If you resell a product that other sellers also offer, your flat file should carry price, quantity, condition, and your own fulfillment choice — nothing else. Every extra populated column is a chance to trigger the conflict.

Variation errors (8545 / 8007) are almost always ordering and spelling. The parent row must exist, must come before children in the file, and every child must repeat the exact same values for the theme columns. Building the family in one file — instead of parent first, children later — eliminates most of these.

The Pre-Upload Checklist That Prevents Most Errors

Run this before every bulk upload. It takes five minutes and routinely saves a full day of error-report archaeology:

Copy-quality errors are errors too. Flat files validate structure, but the content inside valid cells still decides whether the listing converts — and whether it reads well to Amazon's AI features like Rufus. A technically valid upload with a vague title and generic bullets is a quieter, more expensive problem than error 90220, because nothing warns you.

When a Listing Is Stuck: Suppressed, Stranded, and Inactive

Sometimes the upload succeeds but the listing does not go live. Three states to check in the Fix Your Products or Manage Inventory screens:

The same discipline applies: change the smallest set of fields possible, upload, re-check. Wholesale re-uploads of an entire catalog to fix one stuck SKU are how catalogs accumulate mystery errors.

Preventing Flat File Pain Long-Term

Three habits compound over a year of catalog management:

Frequently Asked Questions

Where do I find the error report for my flat file upload?

In Seller Central, go to Add Products via Upload → Manage Your Feeds (or Batch Processing, depending on the interface version). Click the feed's Processing Report link. It lists every rejected row with its error code and message — it is the single source of truth for what actually failed.

Why did some of my rows update even though the upload reported errors?

Amazon processes each row independently. Valid rows go live and invalid rows are rejected, so a feed with 100 rows can successfully update 97 of them. That is why reading the processing report matters even when the upload looks successful — silent partial updates are the most common cause of "half my catalog is wrong" situations.

What does error 8541 mean and how do I fix it?

Error 8541 means your SKU matched an existing ASIN, but key attributes in your file (typically brand, barcode, condition, or title) conflict with Amazon's existing record. The fix is reconciliation: make brand, barcode, and condition identical to Amazon's data, and only vary the fields you deliberately intend to update, such as price or quantity.

How do I fix error 8560 "you cannot update this ASIN"?

This error means the detail page is controlled by another seller or the brand owner. Strip your file down to the fields you are entitled to set — price, quantity, condition, fulfillment channel — and leave title, images, and description empty. If you are the brand owner and still blocked, escalate via Brand Registry support.

Can I upload flat files for categories I am not approved in?

No. Gated categories reject rows regardless of file quality. Apply for category approval through the normal Add a Product flow first; once approved, your flat file uploads will process normally.

Do flat file errors affect my ranking or account health?

Rejected rows do not directly harm ranking or account health — they simply do not go live. The indirect risk is real, though: suppressed listings from bad attributes lose visibility, and repeated low-quality listings can attract listing-quality suppression. Fix errors promptly rather than leaving rows in a rejected state.

Is there a way to check my listing copy before uploading?

Yes. Structural validation happens on Amazon's side, but the quality of what you write — title length, banned words, vague bullets, compliance-sensitive claims — you should check yourself. Running your copy through a free Amazon listing checker before generating the flat file catches most content-level problems in minutes.

Bottom line: flat file errors feel arbitrary but are not. Fresh templates, small batches, precise reconciliation, and a pre-upload checklist clear the vast majority of them. And once the structure is clean, the copy inside it is what earns the clicks — check it before you ship.

Create your free account →

Related: Try the free Amazon Listing Checker →