etsy — independently scanned and version-tracked by SaferSkills.
SaferSkills independently audited etsy (Agent Skill) and scored it 100/100 (green). The audit ran 55 deterministic rules across Security, Supply Chain, Maintenance, Transparency, and Community; it found 0 high-severity and 0 lower-severity findings. The full rule-by-rule trace and per-finding evidence are below. Free, methodology-open.
Findings & checks · 0 flagged
Every scanned point with the score it earned and what moved between them.
First recorded scan — no prior version to compare against.
The primary manifest — the file an agent reads to learn what this artifact does.
Applying chosen keywords and merchandising decisions to Etsy listing fields — title, the 13 tags, category/attributes, description, photos, and listing video — and diagnosing an Etsy listing's search performance through Etsy's own first-party surfaces (the per-listing Search Visibility page, shop stats, and engagement rate).
Etsy is a marketplace search system, not a generic storefront and not Google organic search — its listing model and search algorithm are Etsy's own, and they differ sharply from generic web SEO. This skill covers Etsy listing fields, Etsy search visibility, Etsy ranking diagnostics, the Etsy Open API listing surface, and the Etsy side of POD-managed listing sync. It is intentionally narrower than keywords: use keywords to research and cluster search demand, then use this skill to translate selected buyer phrases into Etsy's concrete listing fields and constraints.
An Etsy listing is shaped by its title, category, attributes, description, tags, images, video, price, shipping/processing details, return policy, shop context, and listing state. Current public Etsy docs preserve these hard field facts:
Etsy search runs in two phases: query matching and ranking.
Query matching decides which listings are eligible for a query. It now takes a holistic view of the listing — title, tags, attributes, categories, description, first photo, reviews, and other listing/shop information — rather than scanning only the title and tags.
Ranking orders the matched set by likelihood of purchase, weighing the signals Etsy publicly names: relevancy (how proximate the query terms are to the listing's tags/title/attributes/description, with multi-word phrase matches weighted); listing engagement rate / listing quality (clicks, views, favourites, and conversions per impression — Etsy's 2026 framing calls this the Listing Engagement Rate); recency (a small, temporary new-/re-listing boost so Etsy can learn the listing's quality); shipping price/method and free-shipping signals; customer-and-market experience / shop quality (reviews, completeness, policies, and Star Seller trust status); shopper personalization / context-specific ranking (the searcher's own habits, location, language); translations/locale; and frequency capping.
*Semantic search (2026): Etsy now applies large-language-model / semantic matching to infer buyer intent, not just exact character matches — a search for "gift for a gardening mum" can surface listings tagged "garden tools" or "plant lover gift." Exact multi-word phrases still win the query-matching phase, but covering the concept space* (synonyms, recipient, occasion, style) across your 13 tags, attributes, and description now matters more than under pure exact-match.
Relevancy gets you seen; quality keeps you ranked. The engagement score is a feedback loop: a listing that earns clicks and conversions on its impressions is shown more; one that gets impressions but no clicks is demoted. Title/tag optimisation is necessary but not sufficient — the photo, price, free/low shipping, and video drive the click-and-convert half. Do not buy Etsy Ads to mask a listing that converts poorly organically; fix conversion first.
Use this diagnostic map before concluding a problem is keyword-only:
| Symptom | Likely Etsy-side question | What to inspect first |
|---|---|---|
| No impressions after publish | Is the listing indexed and eligible yet? | New/edited-listing timing (a new listing can take up to ~48 hours to appear in search/categories), policy status, listing state, category, image, return policy. |
| Impressions but low clicks | Does the result earn attention? | Primary photo, concise title, price, shipping badge/price/free-shipping treatment, video, reviews, and whether the query intent matches the product. |
| Clicks but low sales | Does the listing answer purchase objections? | Supporting photos, description first sentences, size/material/fit details, processing time, returns, personalization, price, shipping, trust signals. |
| Rank differs by browser/device/account | Is this personalization or filters? | Etsy's context-specific ranking, buyer location/language, filters, frequency capping, and shop stats — rather than manual self-search. |
| Drop after a title/tag change | Did the edit remove an actual matched phrase or reset learning? | Pre-edit title/tags/attributes/description, shop-stats query terms, and a re-check window instead of same-day rank checking. |
| Search Visibility warning | Is Etsy flagging a quality/completeness issue? | Search Visibility page issues: image, primary-photo quality, specific category, return policy, US shipping price/free-shipping treatment, shop completion, customer service. |
Do not claim "rank improved" from a single manual search. Use Etsy shop stats, query terms where available, impressions, clicks, favourites, purchases, conversion rate, and the Search Visibility page. Baseline before edits, record the changed fields, and give Etsy time to re-index and re-learn engagement before judging.
Write the title for a human, then check it for the algorithm — not the reverse. Older Etsy advice pushed long keyword-packed titles; Etsy's 2026 public guidance (Seller Handbook, "New Guidance for Listing Titles, and a Tool to Help") says search now uses a broader listing view and title readability matters for buyer confidence and conversion. Keep the title clear and scannable: name the item once, front-load the objective traits shoppers must see first (product type, material, colour, size, personalization when essential), avoid repeated words, omit price/shipping/sale language, and keep aspirational gift phrases out of the title unless essential to the item.
Concrete rewrite: a weak title like Mug, Coffee Mug, Tea Mug, Ceramic Mug, Handmade Mug, Gift Mug, Mother's Day Mug repeats one noun and spends buyer attention on variants of the same phrase. A stronger title is Handmade Personalized 11oz Ceramic Coffee Mug for Mother's Day: it names the object once, reads as natural language, and leaves secondary phrases for tags, attributes, and the description.
Title position is a display/CTR concern, not a magic ranking weight. Etsy's current keyword guidance states that where a phrase appears in the title does not by itself affect ranking. Still lead with the concrete product phrase, because buyers scan the beginning first and Google snippets show roughly the first 50–60 characters of the page title. Front-load for readability and click-through, not to game position — and let tags + description carry the long-tail coverage the title can no longer absorb. (This replaces the older "title relevancy lives in the first ~40 characters" framing, which conflated a buyer-scanning/CTR lever with a ranking weight.)
Tags are a recall budget, not a keyword dump. You get exactly 13 slots of ≤20 characters each. Use all 13 when you have 13 accurate, distinct buyer phrases; prefer multi-word long-tail phrases over isolated fragments when they fit within 20 characters, because Etsy matches phrases and most buyers search phrases (a slot spent on a >20-char phrase is wasted — the tag is rejected outright). Do not re-state a term the category or attributes already cover — those fields already act like matching signals, so spend the freed slots on new query coverage (synonyms, occasion, recipient, style), which is what the semantic layer rewards. Do not intentionally add misspellings, and do not add tags in multiple languages unless you are authoring translations in the supported listing flow.
Break long-tail targets into useful chunks. A target such as "minimalist diamond engagement ring" exceeds 20 characters — split it into accurate phrasal tags such as minimalist jewelry, diamond ring, and engagement ring rather than one-word debris. Preserve true buyer language across title, tags, description, categories, and attributes instead of copying the same phrase into every field.
The description's first lines are SEO, not boilerplate. Etsy's semantic query-matching phase reads the description for context, so open with the listing's most relevant keyword(s) in natural prose and answer the buyer-critical facts (what it is, material/size/fit, what's included, processing expectations, key use, any buyer-critical limitations) — but do not copy the title verbatim (that wastes the surface). Separately, Etsy listings can rank on external search engines: Etsy's SEO Help emphasizes the first sentence (roughly the first 150–160 characters) so it can stand alone as the Google search-result preview — Etsy does not guarantee a fixed meta-description field, so write the opening so it reads well standalone. A description that opens with "Thank you for visiting my shop!" wastes both the Google snippet and the index head.
Use Etsy's per-listing Search Visibility page as the authoritative first-party diagnostic — prefer it over third-party "SEO score" tools. It groups visibility issues into listings, shop, and customer service, and currently calls out the practical inputs Etsy itself weighs: at least one image; a high-resolution primary photo (Etsy recommends ≥2000px); a singular finished-product primary photo; a clear, well-lit image; the most-specific (leaf-level) category; a stated return policy; US domestic shipping under ~$6 for US-search priority; shop completeness (logo/bio/policies/about); and customer-service signals (message response, on-time dispatch/tracking, review score, cases). Changes typically reflect on that page after roughly 24 hours, so do not judge an edit's effect instantly.
Etsy also offers optional AI-powered title recommendations for eligible English listings. Treat suggestions as a current first-party hint, not authority: before applying, export/download listing CSV data so original phrases are not lost; review the suggested title against the product; preserve useful search phrases in tags/descriptions/attributes; apply to a small set first when risk is high; then re-check shop stats after enough time has passed.
For API-oriented work, prefer Etsy's official Open API v3 docs and the Etsy Dev MCP Server over stale remembered endpoint details. The Dev MCP Server supplies current endpoint details, schemas, OAuth scopes, and guides from the OpenAPI spec, but it does not call the Etsy API directly and does not replace marketplace/listing judgment — use it to inspect ShopListing, updateListing, inventory, shipping, personalization, and receipt schemas before coding.
The Etsy Open API v3 listing surface is relevant when the task is automation, but this skill still owns listing semantics rather than generic app architecture.
x-api-key plus OAuth scopes such as listings_r, listings_w, and listings_d (delete).updateListing is a PATCH operation. It accepts fields such as title, description, taxonomy_id, tags, listing state, shipping-profile-related fields, and other listing details.createDraftListing / updateListing title constraints against the official Open API reference or Dev MCP Server before hard-coding punctuation rules such as one-time-only %, :, &, or +.A large share of Etsy listings are fulfilled by an upstream print-on-demand platform (Printify, Printful) rather than authored natively in Etsy. In those workflows the POD platform is the operational source of truth for product configuration, variants, print areas, and publish state, while Etsy remains the source of truth for Etsy listing search behaviour and marketplace policy. You edit the product on the POD platform and publish to push changes to the Etsy listing; the POD product's tags/title map onto the Etsy listing's fields subject to Etsy's hard 13-tag / 20-character limits at Etsy's own boundary. Never assume the POD store's tag set equals the indexed Etsy tag set — verify the live Etsy fields after publish.
Editing a POD-managed listing is asynchronous and lock-gated — publish is not edit success. On Printify, an edit is PUT /v1/shops/{shop_id}/products/{product_id}.json followed by POST /v1/shops/{shop_id}/products/{product_id}/publish.json to push to Etsy; pressing publish (or calling that endpoint) flips the product to `is_locked: true` and emits the product:publish:started webhook event until the channel confirms. A `PUT` to a locked product fails with HTTP 400, error code 8252 "Product is disabled for editing." Treat that as an in-flight publish lock: re-read the product, wait for is_locked to clear, then retry — rather than treating it as a permanent failure. For API/custom-channel publish flows, Printify documents POST .../publishing_succeeded.json and POST .../publishing_failed.json as the status endpoints that remove the locked state; use them only when the channel publish outcome is known, not as a blind workaround for native Etsy publish failures. Tag-only sweeps that ignore the title field leave the title untouched (a tag operation never edits the title), so title and tag remediation are two separate edits.
Full publish can overwrite channel edits. Printify Help warns that republishing can sync/overwrite product information on the sales channel. Use selective publishing when the seller has custom Etsy-side photos, titles, descriptions, pricing, tags, shipping profiles, or mockups that must be preserved — select only the details that should sync; after changing variants, make sure mockups/images sync for new variants or upload them manually.
A publish can FAIL for reasons beyond the lock — read the failure, don't blind-retry. For Printify→Etsy, check these before assuming an API outage: an un-activated Etsy shop or expired/disconnected Etsy connection, an unsupported/unresolvable calculated-shipping profile, a deactivated/expired Etsy listing, Vacation Mode or an inaccessible shop, prohibited title characters or trailing spaces, a price below Etsy's listing minimum (Printify cites the ~$0.20 publishing-fee floor — verify current), or exceeding Etsy's variation/choice limits (Etsy Open API third-variation support does not automatically mean every POD channel flow supports every variation shape). When a publish fails, read the `publishing_failed` reason and fix the specific cause.
Multi-Product Listings (MPL) change the listing-quality math. Printify's Etsy MPL feature combines several Printify products into one Etsy listing at no extra duplicate-listing fee, with one title/description/tag set and multiple product options. This consolidates traffic, reviews, and sales into one listing, but concentrates risk: title, tags, mockups, variants, and out-of-stock state must be maintained at the combined-listing level, and a single member product going out of stock can trigger a republish/relist of the combined listing — which Printify says does not sync automatically without republishing, and which can reset listing recency and disturb ranking. Treat MPL stock changes as listing-level events, not silent inventory updates.
Shipping price is a ranking/visibility lever — and a POD trap. Etsy favours free/low shipping and, for US domestic listings, listings with shipping over roughly $6 can appear lower in US search; a free-shipping guarantee (free shipping on US orders/items of $35 or more) can provide US-search priority placement. Treat both the $6 shipping-price issue and the $35 guarantee as Etsy visibility + seller-economics inputs, not automatic universal rank guarantees. *POD sellers using calculated shipping routinely exceed the $6 line without noticing*, so audit the shipping profile on every POD-managed listing — a great title on a $9-shipping listing still loses rank.
Printful and other POD tools still inherit Etsy limits. For Printful-managed Etsy tags, public Help says Etsy supports up to 13 unique tags and that a tag over 20 characters can surface as an Etsy client exception — do not assume silent truncation or silent dropping; reconcile the live Etsy listing fields after publishing.
This skill exists to make agents apply Etsy through its declared scope, coverage, exclusions, and verification checks instead of relying on generic model memory. The useful behavior is specific: recognize the right task, follow the skill's operating guidance, and prove the result with the listed checks.
is_locked publish-state failure; use publishing_succeeded.json / publishing_failed.json only for API publish flows where the outcome is known; on a publish failure read the publishing_failed reason and fix the specific cause; for an MPL, check whether an out-of-stock member triggered a republish that reset recency; and verify the final live Etsy listing rather than trusting the upstream edit's 200 response.keywords; this skill applies chosen terms to Etsy listing constraints and diagnoses them via Etsy's own surfaces — it consumes keyword research, it does not produce it.seo.title/seo.description, Liquid, Online Store 2.0, Shopify Admin/Storefront API, Shopify webhooks). Use shopify — Etsy's algorithm and limits do not apply there.printify or a provider-specific skill; this skill covers only the Etsy-listing side of that boundary.keywords.Use official vendor docs first; verify against these before relying on a cached figure:
publishing_succeeded / publishing_failed; error code 8252): https://developers.printify.com/API-Doc-RREdits.html<!-- skill-graph-context:start (generated — do not edit by hand) -->
Classification
product-domaintrueecommerce/marketplaces/etsyWhen to use
etsy, etsy seo, etsy listing, etsy tags, etsy search visibilityNot for
Related skills
keywords, printifyseo-strategy, printify, keywords, shopifyGrounding
universalhttps://help.etsy.com/hc/en-us/articles/360000336307-How-to-Use-Tags-to-Get-Found-in-Search, https://help.etsy.com/hc/en-us/articles/115015628707-How-to-Create-a-Listing?segment=selling, https://www.etsy.com/seller-handbook/article/how-etsy-search-works/375461474487, https://www.etsy.com/legal/policy/search-advertisement-recommendation/899478564529, https://www.etsy.com/seller-handbook/article/1399426136697, https://www.etsy.com/seller-handbook/article/keywords-101-everything-you-need-to-know/382774281517, https://help.etsy.com/hc/en-in/articles/25869947521175-How-to-Use-the-Etsy-Search-Visibility-Page, https://help.etsy.com/hc/en-us/articles/360035901534-How-to-Ship-Your-Items-on-Etsy, https://help.etsy.com/hc/en-us/articles/360024198553-How-to-Offer-Free-Shipping?segment=selling, https://help.etsy.com/hc/en-us/articles/360053206073-How-to-Add-a-Listing-Video, https://help.etsy.com/hc/en-us/articles/115015663987-Search-Engine-Optimization-SEO-for-Shop-and-Listing-Pages?segment=selling, https://developers.etsy.com/documentation/mcp_server/devmcpserver/, https://developers.etsy.com/documentation/tutorials/third-variation/, https://developers.printify.com/API-Doc-RREdits.html, https://help.printify.com/hc/en-us/articles/4483629961489-How-do-I-use-selective-publishing-on-my-sales-channels, https://help.printify.com/hc/en-us/articles/4483630521105-Why-was-my-product-information-overwritten, https://help.printify.com/hc/en-us/articles/4483617102097-Why-can-t-I-publish-my-products-to-Etsy, https://help.printify.com/hc/en-us/articles/45606975744529-How-can-I-create-a-Multi-Product-Listing-on-EtsyKeywords
etsy seo, etsy tags, etsy listing, etsy title, etsy search ranking, etsy search visibility, etsy listing video, etsy open api, printify to etsy, etsy free shipping<!-- skill-graph-context:end -->
~30 seconds. Free. No account. Every finding cites a rule and a line of evidence.