Shopfront
Troubleshooting

Resolve held listings

Quick answer

Answer missing marketplace details, review guessed values and send eligible held listings when they are ready.

Why is a listing held?

A Held: message means Shopfront has paused that marketplace listing because it needs an item detail or account setup. Read the message on the item's channel row. Other marketplaces can still publish independently.

A held listing is different from a marketplace rejection. For an Error badge, use Listing failed.

How do I answer missing details?

  1. Open the item and select Add details, or select List held items in a workflow selection toolbar and choose the marketplace.
  2. Read the Marketplace needs a few details card. Pick the correct value for each item. Pick one for all applies only to the items shown for that question.
  3. If the card offers a search, search the marketplace's values and choose the correct result. Some details open the item's editor in the same card.
  4. Select Send to Marketplace or Send N items to Marketplace once the details are complete. A Save answers button saves the choices for the action that opened the card instead of publishing immediately.
  5. Check the result and each item's channel status.

Items left unanswered stay held. One card covers up to 20 items; use List held items again for the next group. Read Not included: messages to understand why an item cannot be sent.

What does Check guesses do?

When Shopfront used a likely value, Check guesses lets you review it. Choose Keep to confirm the value, or pick another marketplace value. This can include items that are already listed, so check whether a saved correction also needs Apply or a relist to reach the marketplace.

Owners and admins can change When Shopfront isn't sure between Use the best guess and Ask me, either in the card or in Settings → Selling → Listing preferences. This choice does not remove the need to check item facts.

What if the marketplace account needs setup?

Open Settings → Selling → Connected marketplaces and resolve any Publishing paused, Publishing held or Reconnect required message. For eBay, use Complete eBay setup when offered and resolve missing policies.

Once setup is complete, check each item's current channel status. If an item remains held, use List N held items on Marketplace on the channel card, or List held items in the workflow selection. Confirm that it is listed before assuming account recovery has resolved the hold.

Why does an item remain held after I send it?

Shopfront checks readiness again before sending. An item can stay held if a required detail is still missing or the account is not ready. Items that are already live, still being sent, sold, or tied to an existing marketplace draft may be skipped.

Read the latest reason, correct it and retry the affected item. If the card cannot save or send the details, refresh the page and open it again. Contact support with the marketplace, item and exact message if it continues.