My Etsy draft listing didn't publish — what's wrong?

A project completes, the files land in Drive, the listing copy is written — but no draft appears in your Etsy shop manager. This article covers the three things that account for nearly every Etsy publish failure.

Start by checking the Logs tab on the project page. The etsy_publish_task line tells you exactly which Etsy API call failed and what the error code was.

Cause 1: Expired OAuth token

Etsy tokens expire and need refresh. Elistit’s etsy_token_refresh worker refreshes them automatically in the background, but if your token expired while your shop was disconnected or while Etsy’s OAuth endpoint was down, the next publish attempt will fail with a 401.

Fix: Go to Integrations → Etsy and click Reconnect on the affected shop. The OAuth flow takes ~30 seconds. After reconnecting, the project can be retried (see “Retrying a publish” below).

Cause 2: Missing shipping profile

Etsy requires every listing — even digital ones — to have a shipping profile assigned. If you haven’t set up a shipping profile in your Etsy shop manager, the publish call fails with a validation error.

Fix: In Etsy → Shop Manager → Settings → Shipping Settings, create at least one shipping profile (digital downloads use “No shipping needed” but still need the profile entry). Then go to Integrations → Etsy → [your shop] in Elistit and set it as the default in your saved listing defaults.

Cause 3: Missing or invalid taxonomy

Etsy listings need a taxonomy_id (the category — “Wall Decor → Posters & Prints” etc.). Elistit can usually pick this automatically from the product type, but if your shop has no default taxonomy and the project didn’t carry one, the publish fails.

Fix: Set a default taxonomy in Integrations → Etsy → [your shop] → Saved defaults. This applies to all future drafts; existing failed projects can be retried after.

Other causes (less common)

Image upload limit hit — Etsy allows 10 images per listing. Elistit caps uploads to 10, but if Etsy is rate-limiting your shop you’ll see this fail intermittently.
Digital file format — Etsy supports PDF, JPG, PNG, ZIP, MP4 etc. Unusual formats (RAW, PSD, AI) are rejected.
Commercial license not active — Etsy’s commercial API license must be active on Elistit’s side. It is (approved 2026-05-05) but if Etsy has revoked it for any reason, all publishes will fail. We’d post a status update if this happened.

Retrying a publish

Elistit retries failed listing creation automatically on a schedule (listing_retry worker), with the retry count and next-retry time visible on the project page. You don’t need to do anything for the retry to happen.

If three retries fail, the project sits at listing_failed. To force a fresh attempt:

Fix the underlying cause (reconnect token, set shipping profile, set taxonomy).
From the project page, click Retry Etsy publish.

Checking shop-level health

The Etsy dashboard (/etsy) shows a connection health indicator for each shop. A red dot means the token has expired or the connection was revoked from inside Etsy. Don’t ignore it — fix the connection before launching new projects, otherwise every one of them will produce a listing_failed at the tail.