Troubleshooting
Quick answer
Fixes for failed listings, a missing or outdated extension, a disconnected channel, an undetected sale, a stuck or duplicated import, and a price change that didn't reach the marketplace.
Which guide do I need?
Listing failed
A channel row shows Error
Extension not detected
Shopfront asks you to install or update the extension
Channel disconnected
A channel card shows Reconnect required
Sale not detected
An item sold but Shopfront still shows it as active
Import stuck or duplicated
An import isn't finishing, or listings are waiting in Needs review
Price change not applied
You changed a price but the marketplace still shows the old one
Still stuck?
If none of these fixes it, contact support with the marketplace and the exact message you see.
Public API
The API Reference documents the Shopfront public API at https://api.shopfront.app, with the OpenAPI file at https://docs.shopfront.app/api/openapi.yaml; send your API key as a bearer token, and GET /v1/health needs no key. POST /v1/products/generate is retired and returns 410 Gone, so use POST /v1/listings/generate.
Listing failed
Select View details on the channel row with the Error badge to see the error, its code and the next step, such as reconnecting the marketplace, adding a missing eBay business policy or replacing rejected photos. Fix the cause, check the marketplace for the item, then select Retry Listing.