Skip to main content

How to Fix Listing Errors

Learn how to identify and resolve common listing errors in Zentail, including missing required attributes, images, and product data — across any sales channel.

Written by Dan Sugarman

Why is my product not listing to a sales channel?

If a SKU is failing to list on a channel like Walmart, Amazon, or others, one of the most common causes is missing or invalid required attributes. Each channel requires specific product data fields before it will accept a listing. When these fields are blank or contain invalid values, you'll see errors in Zentail such as:

  • [ERROR] product_data — a required attribute is missing or has no valid value

  • [ERROR] label_image — a required image field is missing a value

  • [ERROR] pricing — the SKU and Product ID combination couldn't be matched, often because item setup isn't complete

  • [ERROR] inventory — inventory can't sync because the item setup on the channel's side is incomplete

These errors often appear together. The good news is they can all be resolved by filling in the missing data directly on the product in Zentail.

Common required attributes that cause listing failures

Depending on your product's category and the channel you're listing to, different attributes may be required. Some of the most frequently missing ones include:

  • Label Image — Required for many categories, especially in Health & Beauty on Walmart. You must provide at least one valid label image URL.

  • Category-Specific Product Type — Many channels require a valid value from a predefined list (e.g., a specific "type" field for your product category).

  • Ingredients Statement — Required for consumable or personal care products.

  • Key Features / Bullet Points — Required for most categories across major channels.

  • Manufacturer / Brand — Must be filled in and match what the channel has on record.

  • Shipping Weight / Package Weight — Missing weights can cause channels to reject item setup.

  • Unit Count / netContent — This is a required field on Amazon and Walmart for most products.

How to fix missing attribute errors

Step 1: Open the product in Zentail

Navigate to the SKU that has the error in your Zentail catalog and open the product detail page.

Step 2: Use the wrench icon to edit channel-specific attributes

Click the wrench icon on the product to open the channel attribute editor. This is where you can fill in channel-specific required fields, including images and product attributes.

Step 3: Use Listing Prep to find valid attribute values

For category-specific fields, channels often only accept values from a predefined list. Use Listing Prep in Zentail to look up the valid values for your product's category before entering them.

IMPORTANT! Make sure to select All if you can't find the attribute you are looking for, sometimes there are conditional requirements that are required only based on the other data you are sending but not for the everything with that Product Type

Step 4: Update and Push to the channel

Once you've filled in the required fields, save your changes and re-attempt the listing. The errors should clear once the channel receives the complete product data.

Note: This will happen automatically but if you want to confirm on one product, this is the fastest way to see the change.

Why am I also seeing pricing and inventory errors?

Pricing and inventory sync errors are often downstream of product data errors. Channels won't sync price or inventory for an item that hasn't been fully set up yet. Fix the product_data errors first — once the item is live on the channel, pricing and inventory errors typically resolve on their own.

If they persist after the item is set up, check that your pricing rules and inventory are configured correctly in Zentail for that channel.

Still seeing errors after making changes?

If you've filled in all the required fields but errors persist:

  • Double-check that all attribute values are from the channel's approved list — use Listing Prep to verify

  • Make sure any image URLs are publicly accessible

  • Check for duplicate UPCs or EANs across multiple SKUs in your catalog — each barcode should only be used by one SKU

  • Reach out to Zentail support and share the full error text — this helps pinpoint the exact field causing the issue

Did this answer your question?