> ## 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.

# Listings Failing Feedonomics Validation, Mercari

> Listings Failing Feedonomics Validation for Mercari stores. Tracked live in Vortex IQ Nerve Centre. How to read it, why it matters, and how to act on it.

**Card class:** [Hero](/nerve-centre/overview#card-classes-explained)  •  **Category:** [Marketplace](/nerve-centre/connectors#connectors-by-type)

## At a glance

> **Listings Failing Feedonomics Validation** is the share of listings that fail Feedonomics feed validation before they ever reach Mercari. It is a cross-channel card comparing your Feedonomics feed against your intended Mercari catalogue, so the gap lives in the feed tool, not on Mercari. A failed listing simply never publishes.

|                       |                                                                                                                                                                   |
| --------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **What it counts**    | The percentage of listings rejected by Feedonomics feed validation rules before distribution to Mercari.                                                          |
| **Sample type**       | Backend API data from Mercari, refreshed on the standard data refresh.                                                                                            |
| **Why it matters**    | Listings that fail validation never go live, so they earn nothing and you may not notice they are missing. A rising rate quietly shrinks your sellable catalogue. |
| **Reading the value** | A percentage of attempted listings. Lower is better. Above 5% means a meaningful slice of your feed is being blocked.                                             |
| **Currency**          | percent                                                                                                                                                           |
| **Time window**       | `7D`                                                                                                                                                              |
| **Alert trigger**     | `>5%`                                                                                                                                                             |
| **Sentiment key**     | `mer_xc_feed_rejection_vs_listings`                                                                                                                               |
| **Roles**             | owner, operations, engineering                                                                                                                                    |

## Calculation

Vortex IQ compares the listings rejected by Feedonomics validation against the total listings submitted to the feed over the window, then expresses the rejections as a percentage. Failures come from feed-side rules such as missing required attributes, malformed values, or category-mapping problems, all caught before a listing is sent on to Mercari. Because this measures the feed tool rather than Mercari itself, a high rate here can sit alongside a healthy-looking live catalogue, since the failed items simply never appeared.

## Worked example

*A representative reading of **Listings Failing Feedonomics Validation** for a typical Mercari reseller.* On 24 Mar 26 the card reads 8.2%, above the 5% line. Of roughly 600 listings pushed through the feed that week, around 49 were rejected. Drilling in, most failures cluster on a missing brand attribute and a handful on an invalid condition value that does not map to Mercari's grading. The reading tells you those 49 items never published and are silently absent from Mercari, costing you sales you never saw fail. The action is to fix the feed rules: backfill the brand attribute and correct the condition mapping so 'Good' and 'Like New' translate cleanly. Cross-reference [`mer_xc_catalogue_drift_vs_bc`](/nerve-centre/kpi-cards/mercari/listings-drifting-from-bc) to see whether the same data quality gaps are also causing drift on items that did publish, and [`mer_listings_active`](/nerve-centre/kpi-cards/mercari/active-listings) to confirm the live count is lower than your catalogue intent. Vortex Mind traces upstream causes such as a feed-template change that dropped a required field, and Ask Viq answers plain-English questions like "what was the top validation failure reason this week".

## Sibling cards merchants should reference together

| Card                                                                                                              | Why merchants reach for it                                                    |
| ----------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------- |
| [`mer_xc_catalogue_drift_vs_bc`](/nerve-centre/kpi-cards/mercari/listings-drifting-from-bc)                       | The same data quality gaps that fail validation often cause drift downstream. |
| [`mer_xc_listed_but_oos_on_bc`](/nerve-centre/kpi-cards/mercari/active-mercari-listings-for-sold-elsewhere-items) | Another cross-channel sync card worth checking when feeds misbehave.          |
| [`mer_listings_active`](/nerve-centre/kpi-cards/mercari/active-listings)                                          | Confirms how many listings actually made it live versus the intended count.   |
| [`mer_listing_quality_score`](/nerve-centre/kpi-cards/mercari/listing-quality-score)                              | Poor attribute completeness drives both validation failure and weak quality.  |
| [`mer_revenue_at_risk`](/nerve-centre/kpi-cards/mercari/revenue-at-risk-live)                                     | Quantifies the revenue exposure from listings that never publish.             |

## Reconciling against Mercari

**Where to look in Mercari's own dashboard:**

Mercari only knows about listings that successfully reached it, so a failed feed item leaves no trace in the Mercari dashboard. The validation failures live in your Feedonomics feed logs, where each rejected row carries the rule it broke. The comparison here is your Feedonomics feed versus your intended Mercari catalogue, which means the Mercari dashboard alone will not show the gap because the missing items never arrived.

**Why the Vortex IQ value may legitimately differ:**

| Reason                                                                                                                         | Direction | What to do               |
| ------------------------------------------------------------------------------------------------------------------------------ | --------- | ------------------------ |
| **Period boundary.** Feed runs near the window edge may shift which failures fall inside the 7-day window.                     | Variable  | Match the period range.  |
| **Time zone.** Feed-processing timestamps may sit in a different zone to your dashboard.                                       | Marginal  | Confirm time zone match. |
| **Filter scope.** Only listings routed through Feedonomics toward Mercari are counted; manually created listings are excluded. | Variable  | Match filter settings.   |

**Cross-connector reconciliation:** Because this compares Feedonomics against your Mercari intent, fixes belong in the feed configuration, not in Mercari. For divergence investigations, use Vortex Mind.

## Known limitations / merchant FAQs

**Q: How often does Listings Failing Feedonomics Validation update?**
It refreshes on the standard Vortex IQ data refresh, recalculating the rejection rate from the latest Feedonomics feed runs over the 7-day window.

**Q: Why does my Mercari dashboard show a different number?**
Mercari never sees the failed listings, so it cannot report on them. Any number you compute from Mercari alone will understate the problem because the rejected items are simply absent.

**Q: Mercari is not a standard Feedonomics destination, so why does this card apply to me?**
Some merchants distribute to Mercari through Feedonomics. If you do, this card catches listings blocked in the feed before they publish. If you do not route Mercari through a feed, the card will read zero.

**Q: Can I customise the alert threshold?**
Yes, sensitivity thresholds are configurable per profile in the Sensitivity tab. Adjust to match your business baseline rather than relying on the generic default.

***

### Tracked live in Vortex IQ Nerve Centre

*Listings Failing Feedonomics Validation* is one of hundreds of KPI pulses Vortex IQ tracks across Mercari and 70+ other ecommerce connectors. Nerve Centre runs the detection layer; Vortex Mind investigates the cause when something moves; Ask Viq lets you interrogate any number in plain English.

[Start for free](https://app.vortexiq.ai/login) or [book a demo](https://www.vortexiq.ai/contact-us) to see this metric running on your own data.
