Skip to main content

Understanding, Managing, and Fixing Errors

Where Zentail shows listing errors, what each listing status means, and the types of errors channels return.

Written by Dan Sugarman

This article explains where Zentail shows listing errors, what each listing status means, and the kinds of errors channels return. For step-by-step instructions, see How to Fix Listing Errors.

Where you see errors

  • Listing Status (Listing → Listing Status) shows every listing on each channel, grouped by status. Its Top Fixes list ranks the fixes that would get the most listings live. For a tour of the page, see Listing Status Overview.

  • Quick Edit outlines each cell that has an error. A badge on the row opens that row's errors.

  • The product page lists one product's errors on each channel. Click Errors in the product's sidebar.

  • Download errors, at the top of a channel's Listing Status page, downloads that channel's errors as a file.

Which statuses mean a listing isn't live

On each channel's Listing Status page, listings fall into three groups:

  • Not Selling: in your catalog, but earning nothing on this channel right now.

  • Live, Needs Attention: selling, but something is blocking updates or costing you sales.

  • Healthy: live, purchasable and syncing with no errors. Nothing to do.

Here is what each status in the first two groups means, and what to do about it. The buttons named are on the status's row.

Status

What it means

What to do

Listed with Attribute Error (Not Selling)

The channel rejected it over product attributes, so it never went live.

Click Attribute errors, then Fix in Quick Edit.

Listed with Other Error (Not Selling)

The channel rejected it for something other than attributes.

Click View SKUs and read the channel's message. Fix what it names, then click Update & Push.

Submitted, pending (Not Selling)

Sent, with no answer from the channel yet.

Wait for the channel. If listings stay here, click Resubmit.

Suppressed (Not Selling)

The channel hides it from search and the buy box until a problem it flagged is fixed.

Fix the flagged problem. Use Attribute errors when the row shows it; otherwise act in the channel's seller tools.

Not on Channel (Not Selling)

Marked published in Zentail, but the channel has no record of it, usually because it was rejected.

Click Attribute errors, then Fix in Quick Edit.

Out of Stock (Not Selling)

Live, with no stock on hand.

Add stock.

Not Purchasable with Error (Not Selling)

Live with stock, but buyers can't purchase it. The channel says why.

Click View SKUs to read the channel's message, then fix it, usually in the channel's seller tools.

Not Purchasable, Page Live (Not Selling)

The product page shows, but buyers can't purchase your offer.

Check the offer in the channel's seller tools.

Not Purchasable (Not Selling)

Live with stock, but buyers can't purchase it, and the channel doesn't say why.

Check the listing in the channel's seller tools.

Published with Error (Live, Needs Attention)

Live and selling, but Zentail can't push updates, so price and content drift.

Fix the error, then click Update & Push.

Two more statuses sit below the groups, under Not counted in channel health:

  • Never Listed: in your catalog but never sent to this channel, usually because required attributes are missing. Click List these, or View SKUs to fill the missing attributes first.

  • Delisted: was live and is now down, ended either by you or by the channel. Click Relist.

Understanding errors

Channel errors come from marketplaces. Validation errors come from Zentail.

Many of the errors you see in Zentail are returned by the channel itself: Amazon, Walmart, eBay, BigCommerce, Shopify and others. Because channels change their rules over time, Zentail can't always fix these automatically, which is where you come in.

Validation errors are checks Zentail runs before it sends a listing. They ask you to fill in attributes, like Title or Color, that every channel would otherwise reject.

Errors don't affect every channel equally. A product can have an error on Amazon but not on Walmart, or list fine on Walmart while eBay returns an error.

Types of errors

Missing attributes

The most common listing error. A required attribute, usually set by the combination of category and channel, is not filled in. Fill it in through Quick Edit or on the product.

Invalid attributes

You are sending a value, but the channel won't accept it. Zentail converts common variations into accepted values, so Size "S", "small", "Small" or "SM" all work. A value Zentail can't parse, like "$m4LL" instead of "Small", has to be corrected by hand.

Zentail never sends a value the channel won't accept. So an unparseable value can show up as a missing attribute error instead.

Mismatched attributes

Usually on Amazon. If you list against an ASIN you don't control, your product data must match what Amazon has on file before it publishes your listing. For example, Amazon may say the Product Type (Amazon's word for category) doesn't match. Set the Product Type to the value the error names. A broader category often works too: where SHIRT is required, CLOTHING may also be accepted.

Brand approval

Usually on Amazon, with an error like "Amazon must approve your brand before you can use it to list products". You likely can't resolve this in Zentail. Follow the instructions in the error and contact Amazon Seller Support, or use a different Brand value.

For more on specific Amazon errors, see Common Amazon Errors and How to Resolve Them.

Did this answer your question?