> ## Documentation Index > Fetch the complete documentation index at: https://docs.vortexiq.ai/llms.txt > Use this file to discover all available pages before exploring further. # Etsy on Vortex IQ > Monitor Etsy listings, account health and orders, and catch suppressions and sync problems before they cost sales. Monitor Etsy listings, account health and orders, and catch suppressions and sync problems before they cost sales. [Connect or manage this source](https://app.vortexiq.ai/workbench/settings/sources) · [How connecting works](/integrations/connector-catalogue) · [Create a workflow](https://app.vortexiq.ai/workbench/flows/create?connector=etsy) performance signals automated checks automated fixes workflows API operations ### What you can achieve Capabilities are grouped around merchant outcomes, not API terminology. Find failures, leaks and risks before they cost sales. Improve discovery, conversion, campaigns and repeat purchase. Identify missing, inconsistent or outdated product data. Monitor orders, fulfilment, delivery and settlement. ### From connection to verified outcome The controlled sequence every capability follows. Nothing changes a connected system without the approval step. Authorise the source. Scopes are shown before access is granted. Watch the signals against your own baselines, not universal defaults. Run checks and gather evidence specific to your store. Explain what happened, why it matters and the proposed action. You review scope, risk and reversibility before anything changes. Apply through governed connector operations. Confirm the intended result and keep the receipt. No changes are made without the configured approval policy. Read-only operations do not modify the connected system; schedules, access scopes, API usage and data handling remain governed by Vortex IQ controls. ### Monitor performance 39 performance signals. Open an outcome to see its signals and how each one alerts. Read-only operations do not modify the connected system. | Signal | Alert behaviour | What it tracks | | ------------------------------------------------------------------ | ------------------ | ------------------------------------------------------------------------------------------------------------------------------- | | **Average Order Value** | Alert band 0 / -5 | Description pending editorial review; the signal is live. | | **Average Review Rating (Star Seller KPI)** | Alert band 95 / 85 | Star Seller requires 4.8+ avg review over rolling 90d. Drops below = badge loss + visibility penalty. | | **Etsy Ads Revenue vs Organic** | Watch only | Split of revenue from Etsy Ads (paid) vs natural-search (organic). High Ads share = consider organic SEO investment. | | **Etsy Fee % of Revenue** | Alert band 12 / 18 | Total fees / gross revenue. Etsy: 6.5% transaction + $0.20/listing/4mo renewal + 3% + $0.25 payment + Ads if running. | | **Etsy Shop Health Score** | Merchant rule | Composite: review-rate x on-time-ship-rate x active-listing-pct x search-rank-stability. | | **Listings with SEO-Weak Titles** | Alert band 5 / 50 | Titles below 70 chars OR missing key search terms OR repeating brand-only , drives page-rank drop. | | **Orders** | Watch only | Description pending editorial review; the signal is live. | | **Revenue Over Time** | Alert band 0 / -5 | Description pending editorial review; the signal is live. | | **Stale Listings (>180d no update)** | Merchant rule | Stale listings get deprioritised in Etsy search , even a minor edit (title, tag, photo) refreshes the freshness signal. | | **Star Seller KPI (Review / OnTime / Response) Crossed Threshold** | Alert band 95 / 85 | Composite of Etsy's three Star Seller KPIs , any one crossing causes badge loss and visibility cut. | | **Star Seller Status** | Merchant rule | Etsy's seller-quality badge. Requires 95% on-time ship + 5★ avg review + ≤1 response-rate breach in 30d. Loss = visibility cut. | | **Tag Completeness (13 tags max)** | Alert band 90 / 70 | % of listings using all 13 Etsy tag slots , Etsy search algorithm rewards full tag-set use. | | **Top Listings by Revenue** | Watch only | Top Listings by Revenue. | | **Total Revenue** | Alert band 0 / -5 | Description pending editorial review; the signal is live. | | **Views → Favourites Conversion** | Merchant rule | Soft-conversion signal , low rate suggests photo/title/price mismatch with what buyers expected from search. | | Signal | Alert behaviour | What it tracks | | ------------------------------------------- | ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------ | | **AOV by Country** | Watch only | AOV by Country. | | **Buyer Messages Unread** | Watch only | Buyer Messages Unread as exposed by the Etsy integration. The metric is computed from the latest available data and refreshed on the standard data ref | | **Days Since Last Payout** | Alert band 7 / 21 | Description pending editorial review; the signal is live. | | **Marketplace Fees Paid** | Watch only | Marketplace Fees Paid as exposed by the Etsy integration. The metric is computed from the latest available data and refreshed on the standard data ref | | **Oldest Pending Payout (days)** | Watch only | Oldest Pending Payout (days) as exposed by the Etsy integration. The metric is computed from the latest available data and refreshed on the standard d | | **On-Time Shipping Rate (Star Seller KPI)** | Merchant rule | Star Seller requires 95% of orders shipped within seller-declared processing window. Below threshold = badge loss. | | **Orders / Day** | Watch only | Orders / Day over time. | | **Orders by Country** | Watch only | Description pending editorial review; the signal is live. | | **Pending Payouts** | Watch only | Pending Payouts as exposed by the Etsy integration. The metric is computed from the latest available data and refreshed on the standard data refresh | | **Pending Shipment** | Alert band 10 / 50 | Description pending editorial review; the signal is live. | | **Return Rate** | Alert band 5 / 15 | Description pending editorial review; the signal is live. | | Signal | Alert behaviour | What it tracks | | -------------------------------------------------------- | ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------ | | **Active Etsy Listings for OOS SKUs on BC** | Alert band 0 / 5 | Etsy orders you can't fulfil → cancellations → Star Seller demotion. Top-priority sync gap. | | **Cancellation Rate** | Merchant rule | Description pending editorial review; the signal is live. | | **Late Shipments Risking Star Seller** | Merchant rule | Star Seller threshold is 95% on-time over 90d , each late shipment compounds the badge-loss risk. | | **Listings Drifting from BC Source-of-Truth** | Alert band 5 / 50 | Etsy listings where title/price/photo differs from BC source , Etsy's search algorithm weights title heavily. | | **Listings Failing Feedonomics Validation** | Alert band 2 / 5 | Etsy doesn't formally take Feedonomics feeds, but Etsy Ads can be syndicated via Feedonomics where applicable. | | **Net Revenue (after Etsy fees + refunds)** | Alert band 0 / -5 | Net of 6.5% transaction fee + \$0.20/listing/4mo renewal + Etsy Ads spend if applicable. | | **Revenue at Risk (live)** | Merchant rule | (expiring-listings-without-renewal x velocity x ASP) + (page-rank-dropped listings x prior earnings) + (Star Seller loss visibility cost). | | **Same-Item Priced Differently on Etsy vs eBay / Depop** | Merchant rule | Same handmade/vintage item priced very differently across resale marketplaces , buyers find this via Google Shopping. | | Signal | Alert behaviour | What it tracks | | ---------------------------------------------- | ------------------ | -------------------------------------------------------------------------------------------------------------------------- | | **Active Listings** | Merchant rule | Description pending editorial review; the signal is live. | | **Etsy Suspended Listings (24h)** | Alert band 5 / 50 | Etsy suspends listings for handmade-policy violations, prohibited materials, or trademark complaints. | | **Listings Expiring in 30 Days (renewal due)** | Merchant rule | Etsy listings expire after 4 months. Auto-renew costs \$0.20/each , surface so you can decide which to renew vs let lapse. | | **Required-Attribute Completeness** | Alert band 90 / 70 | % of listings with all category-mandated attributes filled (colour, size, material, etc.). | | **Total Listings** | Watch only | Description pending editorial review; the signal is live. | ### Audit risks and opportunities A fix status appears only where the action, inputs, approval, verification and recovery controls are mapped. Candidate remediations are never executable. Open a check for the detail. **Severity** high · **Outcome** Grow revenue · **Fix status** Candidate remediation A listing missing a required attribute is commonly suppressed, down-ranked in marketplace search, or blocked from certain placements entirely, so it can be losing sales without showing any error the seller would notice on the listing itself. A likely corrective operation exists, but its mapping and recovery are not yet complete, so execution is not offered. Evidence and recommended manual steps are provided. Reference: `MARKETPLACE-LISTING-001` **Severity** high · **Outcome** Grow revenue · **Fix status** Report only Seller feedback score is one of the strongest signals marketplace search ranking and buy-box eligibility use, so a drop this size can cost visibility on every listing, not just the ones that triggered the negative feedback. Vortex IQ detects and explains this; resolution is manual, with evidence and recommended steps. Reference: `MARKETPLACE-FEEDBACK-001` **Severity** medium · **Outcome** Grow revenue · **Fix status** Report only The share of revenue this marketplace takes as fees has shifted by more than 2 percentage points from last quarter. On thin-margin products, a shift this size can move a listing from profitable to break-even without anything on the store side changing at all. Vortex IQ detects and explains this; resolution is manual, with evidence and recommended steps. Reference: `MARKETPLACE-FEE-001` **Severity** medium · **Outcome** Run operations · **Fix status** Report only A payout is running more than 7 days behind this marketplace's usual schedule. That is cash the store has already earned sitting outside its bank account, which matters directly to cash flow regardless of how the underlying sales are performing. Vortex IQ detects and explains this; resolution is manual, with evidence and recommended steps. Reference: `MARKETPLACE-PAYOUT-001` **Severity** medium · **Outcome** Grow revenue · **Fix status** Report only Returns on this marketplace jumped more than 50% above the recent average. Beyond the direct cost of the returned goods and return shipping, a spike this size often also damages the seller-performance metrics the marketplace uses for search ranking and account health. Vortex IQ detects and explains this; resolution is manual, with evidence and recommended steps. Reference: `MARKETPLACE-RETURN-001` #### Build your own automated fixes Turn any finding into an automated fix with a Vortex IQ workflow: **over 13,000 read and write operations across more than 200 connectors** are available as building blocks, with approval, verification and rollback on every change. ### Automate approved work Vortex IQ is integrated with **4 read** and **1 write** operations across applicationshops, applicationshoplistingactives, applicationshopreceipts, applicationshopreviews, publicoauthtokens on Etsy. Combine them with anything from the **over 13,000 operations across more than 200 connectors** to automate the work in your own words. Changes follow your configured approval policy: the target, proposed change, affected records, risk, reversibility and verification plan are shown before execution. [Create a workflow](https://app.vortexiq.ai/workbench/flows/create?connector=etsy) #### Ready to build your first Etsy workflow Pick a trigger, add the operations above as steps, and every step that changes data pauses for your approval. Monitoring and audits are live now and can start any workflow you build. | Resource | Read operations | Write operations | | ----------------------------- | --------------- | ---------------- | | applicationshops | 1 | 0 | | applicationshoplistingactives | 1 | 0 | | applicationshopreceipts | 1 | 0 | | applicationshopreviews | 1 | 0 | | publicoauthtokens | 0 | 1 | Signed-in users see the full catalogue in the workflow builder, filtered to the sources they have connected.