Catalog troubleshooting: unpublished items, reason codes, pricing rules, and Product ID fixes

Unpublished Items (in Seller Center's catalog area or, in newer layouts, beside Listing Quality; labels change) lists every non-live SKU by reason. Unpublished means in Walmart's catalog but not on the site: the offer may be fine; the reason says which part is not.

• Content — a required attribute missing or invalid, a non-compliant main image, prohibited claims.
• Pricing rules — far above the same item elsewhere, far below it, or a shipping fee Walmart judges unacceptably high.
• Offer — no price, a site start or end date (your offer's window on the site) that keeps it off, or an unusable shipping template; out of stock is usually a status, not a reason.
• Restricted brand or category — needs approval first.
• Product ID conflict — the GTIN does not match the entry it landed on (a GTIN already in use usually fails earlier, as a feed error).
• Walmart-initiated holds — WFS compliance, trust and safety, potential duplicates (labels change); nothing in your data clears them.

Items can carry several at once.

Reason → check → fix:

• Missing or invalid attribute → the spec's reference tab (Item setup) → single-item edit or content maintenance spec.
• Non-compliant image → replace it.
• Prohibited content → strip the claim, link or promotion.
• Pricing rules → the comparison Walmart used → fair: fix the price (or the shipping template); wrong product, pack or size: a comparable item where offered, or fix the match.
• Offer → price, site dates, shipping template → edit or price template; valid, it republishes.
• Restricted brand or category → request approval where offered.
• Product ID conflict → confirm the GTIN against GS1 and your source, then brand and product type against the catalog entry → fix your data; a case if the catalog is wrong.
• Walmart-initiated hold → the hold type (today under Pending Review): in review resolves itself; a restriction has an Appeal where offered; a flagged duplicate means match, not create → a case only with no appeal and no resolution.

Clearing one exposes the next: note all first.

Content and offer change freely; two identifiers do not:

• The SKU — fixed in practice (Catalog fundamentals): no edit renames it, a WFS SKU never changes, and a seller-fulfilled item takes a new SKU only through the bulk template's SKU-update flag, a one-way replacement that can lose data if misused. Otherwise, a new item.
• The Product ID (GTIN) — the match key, not content. Its one correction path is the bulk update template's Product ID Update flag (labels change); it fails if the new ID is already on another SKU, and WFS items are excluded. Refused or unavailable: retire and set up again under a new SKU, or a case.

A wrong match shows as a page for a different product or size. The opposite fault, a duplicate — your item beside the existing entry for the same product — comes from creating instead of matching (Item setup): retire yours and add your offer by match. A duplicate Walmart has flagged is confirmed from its review; an unflagged one is a case (Partner support cases).

Content maintenance works Listing Quality as a worklist; here, its relation to Unpublished Items:

• Unpublished removes the item from the site. Its reasons are pass or fail: a missing required attribute, a non-compliant image, a price outside the rules.
• Listing Quality lowers visibility. Its content component (empty recommended attributes, too few images, a short name, thin key features) reduces how often the item is found, never takes it down, and is the only component content work moves.

Work them in order: Unpublished first, because a hidden item earns nothing from a better score; then Listing Quality, where one content maintenance spec fills the attributes it names. An item on both: clear the hold, then expect the score to move only after Walmart re-scores, hours or days later.

Sweep both on a schedule (Amazon 3P → Reports and catalog health).

1. Read the reason — every reason, plus SKU, Item ID and GTIN.
2. Fix what is yours — content, price, offer or approval request.
3. Resubmit — note the feed ID and per-item result; an error means it did not land.
4. Recheck Unpublished Items, then the live page: SKU gone, your offer showing.
5. Escalate when a correct fix does not clear the reason, a hold offers no appeal and no resolution, or the catalog entry is wrong.

A republish lags the feed — Walmart's guide quotes about two days for a corrected price or shipping fee. Give a correct fix that window; a pricing reason means adjusting the price, not a case. A case carries the feed ID, SKU, Item ID, GTIN, reason text and what changed (Partner support cases).

Retire versus unpublish. Unpublished is Walmart's hold and clears with the data; retiring is your decision, for data that cannot be fixed in place — it takes a day or two, can be reversed, and SKU or GTIN reuse follows Walmart's current rule.