Published September 11, 2026
What Image Problems Actually Unpublish a Walmart Listing, and the 1000 x 1000 Myth
In the US, Walmart publishes five reason codes for an unpublished item: START_DATE, END_DATE, REASONABLE_PRICE_NOT_SATISFIED, PRIMARY_IMAGE_MISSING and NO_PRICE. Only one is about images, and it fires when there is no primary image at all, not when the primary image is small. No US Walmart document sets a pixel threshold that unpublishes a listing, at any number. The 1000 x 1000 rule repeated across seller blogs is not in Walmart's US documentation. The one automatic resolution unpublish Walmart does document is Canadian, and the threshold there is 500 x 500 pixels.
Two image problems are still worth your attention. A placeholder image blocks publication in the US, stated in plain words in the image guidelines. Walmart's product details policy also says noncompliance with content requirements may result in products being unpublished. That is discretion, not an automated check. Below, every image problem sits next to what Walmart actually does about it. The 1000 x 1000 number gets traced back to its real source, and the last section gives you a fix order for a listing that has already gone dark.
What actually unpublishes a Walmart listing in the US?
The canonical list lives in Walmart's US Marketplace developer docs, on the Get unpublished item insights page. There are five reason codes: START_DATE, END_DATE, REASONABLE_PRICE_NOT_SATISFIED, PRIMARY_IMAGE_MISSING and NO_PRICE. The image one reads: "There is no primary image for your item. After you re-ingest this item with a valid primary image, your item will be republished." Walmart maintained that master list on July 30, 2026, and a resolution threshold still is not on it.
The seller-facing troubleshooting guide, last updated November 25, 2025, covers the same ground in plainer language and adds a few reasons the API does not return. It lists Primary Image Missing with the fix "Update the item with a new Primary Image." Everything else on it is money or identifiers: Price Missing, Egregious Shipping Cost, Reasonable Price Not Satisfied, Pricing Error and UPC Mismatch. Three of those are pricing, one is shipping, one is the product ID, and one is the image.
So Walmart's own two lists do not agree on scope, and neither has ever mentioned pixels. If your listing went dark and you did not touch the gallery that week, check your price and your shipping cost before you rebuild a single image. Price is the far more common cause. Check two quieter causes after a bulk feed upload as well. START_DATE unpublishes an item whose start date is in the future, and Walmart says it will publish once that date arrives. END_DATE unpublishes an item whose end date has passed, and republishing needs a re-ingest with new dates.
What does Walmart do about each image problem?
Three problems take a US listing down or hold it, plus one that applies only on Walmart.ca. Everything else costs you score. "Fix now" means Walmart documents that the listing is down or will not go live. "Fix second" means you are missing a documented spec, which costs you zoom and Listing Quality content score. "Ignore the panic" means the rule you are worried about does not exist in US documentation.
The Canada row is fenced off on purpose. That 500 x 500 automatic unpublish is written in Walmart Canada's item image guidelines and appears nowhere in the US ones. If you sell on Walmart.ca it is real and it is automatic. If you sell only on Walmart.com it does not apply, and neither does any other pixel floor. None of this is a reason to ship sloppy images. Missing the spec still costs you zoom, score and shopper confidence. It just does not cost you the listing.
| Image problem | What Walmart actually does | Where it is documented | Urgency |
|---|---|---|---|
| No primary image | Unpublishes the item. Reason code PRIMARY_IMAGE_MISSING. It republishes after you re-ingest a valid primary image. | US developer docs, Get unpublished item insights (updated Jul 30, 2026) | Fix now |
| Placeholder image left in the gallery | The item will not publish until you replace it with an actual product image. No reason code fires for this. | US image guidelines (updated May 12, 2026) | Fix now |
| Primary image below 500 x 500, Walmart.ca only | Unpublished automatically. This rule exists only in the Canadian guidelines. | Walmart Canada item image guidelines (updated Oct 31, 2024) | Fix now if you sell in Canada |
| Policy-violating content: watermarks, promo claims, other retailer logos, non-English text | No automated check. Walmart states noncompliance may result in products being unpublished, and reserves removal of content plus account suspension. | US image guidelines and Product details policy (updated May 21, 2026) | Fix now |
| Misses a published image spec: below 1500 x 1500, fewer than four images, loose framing, wrong aspect or format | Nothing is unpublished. You lose zoom and content quality score. | US image guidelines; Item Listing Quality Details API; 50% fill from Walmart Canada's Listing Quality Dashboard | Fix second |
| Low image resolution generally, US listings | Nothing. No US document sets a pixel threshold that unpublishes a listing, at any number. | Absent from the US reason codes, image guidelines and product details policy | Ignore the panic |
Where did the 1000 x 1000 rule come from?
It was not invented. It is real Walmart guidance from the wrong country. Walmart Chile's quick guide to photo formats tells sellers: "Sube imágenes de 2000x2000 pixeles (o más) y de mínimo 1000x1000 pixeles." Upload images of 2000 x 2000 or more, and a minimum of 1000 x 1000. That page was last updated on November 19, 2024, and even it attaches no unpublishing to the number. Somewhere in the restatement chain, a Chilean minimum picked up a US enforcement action it never had. Walmart Canada's newer image guidelines page carries 1000 x 1000 as well, as its minimum for zoom rather than a bar to publication.
The mechanism is easy to see once you look for it. Vendor posts assert the consequence and cite no Walmart URL for it. No link, no document reference, no reason code. A rule that takes your listing down would be written on Walmart's own site, and it is not written there. That is repetition, not reporting.
Search for this today and the answer engine will hand you 1000 x 1000 as the threshold, because it is summarising those posts rather than the documentation. That is an observation, not a measurement. The habit that protects you is the same either way: open Walmart's own page and search it for the number before you believe someone else's summary of it.
Does Walmart unpublish listings under 500 x 500 pixels?
On Walmart.ca, yes. Walmart Canada's item image guidelines say it outright: "SKUs with primary images below the minimum resolution standards (500 x 500 pixels) will be unpublished automatically." That is a genuine automated threshold with a genuine consequence attached. It is also the only one Walmart documents anywhere, and it governs Walmart.ca. The page carries a last updated date of October 31, 2024.
Do not import it as a US floor, or you have swapped one myth for another. The US numbers are different and higher, and our post on Walmart zoom image size sets them out. The two documents also do different jobs. Canada's is a floor with an automatic consequence attached. The US spec costs you zoom and content quality score when you miss it, and nothing more. A US seller who trusts a 500 pixel floor ships 600 pixel images and fails zoom on every one of them.
The date spread is the whole argument in one line. US reason codes, updated July 30, 2026. US image guidelines, May 12, 2026. US product details policy, May 21, 2026. The Canadian page carrying the auto-unpublish rule, October 31, 2024. Walmart Canada also runs a newer image guidelines page, updated 25 February 2026, and that one carries no automatic unpublish rule at all. Two live Canadian pages, and the rule everyone quotes survives only on the older one. Our US versus Canada comparison has the full divergence, spec by spec.
What stops a Walmart listing going live if the primary image exists?
Placeholder images. Walmart's US image guidelines describe a placeholder as "intended only for temporary use when product images are not yet available." They then state the consequence plainly: "Your item won't be published until you've replaced the placeholder image with an actual product image." That is a publish blocker written into US documentation, and it is not one of the five reason codes you will get back from the API.
The distinction matters if you are debugging programmatically. PRIMARY_IMAGE_MISSING is the only image-related reason code, and that holds. It is not the same claim as "a missing primary image is the only image problem that can stop a listing." A placeholder is technically a primary image, so the code does not fire, your insights call looks clean, and the item still does not go live.
This is the row where panic is justified. If you set up a catalogue with grey boxes or coming-soon files while you waited on photography, replace those first. They come ahead of resolution, aspect ratio and everything else in the table. Walmart is not scoring those items, it is holding them. Nothing in your Listing Quality dashboard makes that obvious, so go back through anything you set up in a hurry.
Can Walmart remove an image for policy reasons?
Walmart's product details policy answers the question directly. "What happens if my content doesn't follow all requirements? Noncompliance may result in products being unpublished." The same policy adds: "Violations of this policy may result in removal of offers or content, and/or suspension or termination of your Marketplace account." That page was last updated on May 21, 2026, and the same warning about noncompliance also appears in the image guidelines.
Read the verb. Walmart reserves the right, and it acts on judgment. That is a different risk profile from an automated pixel check, not an absence of risk. A machine measuring 1000 x 1000 would hit every seller equally and instantly, which is why the myth feels so urgent. A human reviewing a policy violation hits the sellers who did something clearly against the rules, at unpredictable timing, sometimes at the account level.
The content rules draw that attention far more often than the technical ones. The US guidelines prohibit watermarks, your name or logo on the main image, and accessories that are not included with the item. They also prohibit claims or promotional language, other retailer or eCommerce logos and names, languages other than English, and content that is explicit, hateful or culturally insensitive. Those are the violations a person spots in a second.
What do bad images cost you when they do not unpublish you?
Listing Quality is where image defects actually land. Walmart's dashboard guide says content quality measures "item name, item description, key features and images," and that "Quality listings drive higher conversion rates and boost product visibility, allowing you to unlock growth opportunities such as the Pro Seller badge." Images sit inside the content score, and the score sits inside visibility. The guide never connects a low score to publish status, which is the point: weak images cost you traffic and conversion rather than the listing itself.
The item Listing Quality Details API is more specific. It returns messages like "This item has only 2 image(s), while this category requires the item have 5 or more images. Please add more images." So the API names a category requirement. Walmart Canada's Listing Quality Dashboard guide, updated 8 June 2026, words the same defect differently, scoring you against the average image count on bestselling items in the subcategory. The US dashboard guide names the five score components and no image defects at all. Walmart publishes neither the category numbers nor the average.
Walmart publishes no per-defect impact figure, so treat any article that promises you a percentage lift for fixing whitespace with suspicion. The documentation supports direction, not size. Our post on Walmart zoom image size covers the resolution and zoom thresholds, and which country's page scores them. If your gallery is short of the category minimum, you need more shots rather than better ones. Picmato can import a Walmart product URL and recommend which of its 45 listing shot types a product needs. Walmart's rules are not encoded into how it plans those shots, and nothing it produces checks your live listing.
Triage: what to fix first, what to fix second, what to ignore
If a listing is down right now, work in this order. The first group is documented as blocking publication. The second group is documented as spec, which means content score and visibility. The third group is the myth, and every hour you spend on it is an hour you did not spend on your price. Nothing here needs a tool or a support ticket to check.
Everything not on this list is a spec miss. Spec misses cost you zoom, content quality score and shopper confidence, and the table above says which is which. None of them takes the listing down. So work the list top to bottom, then go back to the table once the item is live again. The order matters more than the effort. A perfect gallery on a held item earns you nothing until the placeholder is gone.
- Fix now: no primary image. This is PRIMARY_IMAGE_MISSING, and the item republishes once you re-ingest with a valid primary image.
- Fix now: any placeholder image. The US guidelines say the item will not publish until an actual product image replaces it.
- Fix now, Canada only: a primary image below 500 x 500 on Walmart.ca, which is unpublished automatically.
- Fix now: image content that breaks policy, such as watermarks, promotional text or another retailer's logo. Walmart reserves removal and account action for these.
- Ignore the panic: a US listing whose images clear the documented spec but sit under a number you read on a blog. There is no US pixel floor that unpublishes a listing, at any number.
Frequently asked questions
Does Walmart unpublish listings with images below 1000 x 1000 pixels?
No. Walmart's US unpublished item reason codes are START_DATE, END_DATE, REASONABLE_PRICE_NOT_SATISFIED, PRIMARY_IMAGE_MISSING and NO_PRICE, and that page carries no resolution threshold at all. The 1000 x 1000 figure is real Walmart guidance, from Walmart Chile's photo format guide and, as a zoom minimum, from Walmart Canada's newer image guidelines. Neither attaches unpublishing to it. No US Walmart document sets a pixel floor that removes a listing.
What does PRIMARY_IMAGE_MISSING mean, and how do I fix it?
It means Walmart found no primary image for the item, so the listing is unpublished. Walmart's developer documentation states: "After you re-ingest this item with a valid primary image, your item will be republished." The seller troubleshooting guide gives the same fix in plainer words, update the item with a new primary image. Republishing happens once a valid primary image is ingested, so no support ticket is needed.
Is there a minimum image size for Walmart US listings?
There is a documented spec, but nothing unpublishes you for missing it. Walmart's US image guidelines set 1500 x 1500 as the point below which zoom stops working. Our post on Walmart zoom image size carries the rest of the numbers. Missing them costs you zoom and content quality score, not the listing. The 500 x 500 automatic unpublish rule applies to Walmart Canada only, not to Walmart.com.
My Walmart listing was unpublished. What should I check first?
Check price before images. In Walmart's seller troubleshooting guide, most listed reasons are commercial: price missing, reasonable price not satisfied, pricing error and egregious shipping cost, plus a UPC mismatch. Only one reason is about images, and it fires when there is no primary image at all. Also check your start and end dates, since a future start date holds an item until that date arrives.
Can Walmart take a listing down over image quality anyway?
Yes, at its discretion. Walmart's product details policy asks what happens if your content does not follow all requirements and answers: "Noncompliance may result in products being unpublished." The same policy reserves removal of offers or content, and suspension or termination of your Marketplace account. That is a manual judgment about compliance rather than an automated pixel check, so content rules like watermarks and promotional text carry the real risk.
Related on Picmato
Sources
- Walmart Developer Portal: Get unpublished item insights (US Marketplace), updated July 30, 2026
- Walmart Marketplace Learn: Troubleshoot unpublished items (US), updated November 25, 2025
- Walmart Marketplace Learn: Product detail page image guidelines and requirements (US), updated May 12, 2026
- Walmart Marketplace Learn: Product details policy, updated May 21, 2026
- Walmart Marketplace Learn Canada: Item image guidelines, updated October 31, 2024
- Walmart Marketplace Learn Canada: Product Content Page, image guidelines and requirements, updated February 25, 2026
- Walmart Marketplace Learn (Canada): Listing Quality Dashboard, the only Walmart page publishing the image defect thresholds, updated 8 June 2026
- Walmart Marketplace Learn Chile: Formatos de fotos para tus publicaciones, updated November 19, 2024
- Walmart Developer Portal: Item Listing Quality Details API
- Walmart Marketplace Learn: Listing Quality and rewards dashboard (US), updated April 9, 2026