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

# Total Listings, Mercari

> Total Listings 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:** [Non-Hero](/nerve-centre/overview#card-classes-explained)  •  **Category:** [Marketplace](/nerve-centre/connectors#connectors-by-type)

## At a glance

> **Total Listings** counts every listing on your Mercari account whatever its state, including active, sold, expired, suspended, and draft. It is the denominator behind your listing-health ratios, and it is distinct from Active Listings, which counts only what is live.

|                       |                                                                                                                                                                                                            |
| --------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **What it counts**    | All listings tied to the account across every state: active, sold, expired, suspended, and draft.                                                                                                          |
| **Sample type**       | Backend API data from Mercari, refreshed on the standard data refresh.                                                                                                                                     |
| **Why it matters**    | It is the baseline your listing-health ratios divide into, such as suspended share or active share. A wide gap between total and active listings tells you how much of your catalogue is dormant or stuck. |
| **Reading the value** | Read it as context, not a target. Compare it against Active Listings to gauge how much of your catalogue is actually working for you.                                                                      |
| **Currency**          | number                                                                                                                                                                                                     |
| **Time window**       | `RT`                                                                                                                                                                                                       |
| **Alert trigger**     | `-`                                                                                                                                                                                                        |
| **Sentiment key**     | `mer_total_listings`                                                                                                                                                                                       |
| **Roles**             | owner, operations                                                                                                                                                                                          |

## Calculation

Vortex IQ counts every listing recorded against your Mercari account regardless of state, summing active, sold, expired, suspended, and draft items into one figure. It makes no judgement about whether a listing is live or earning. Because it spans all states, it sits above Active Listings and serves as the denominator when other cards express a state as a share of your whole catalogue.

## Worked example

*A representative reading of **Total Listings** for a typical Mercari reseller.* On 21 Jun 26 a homeware reseller sees Total Listings at 420 while Active Listings reads 180. The 240-item gap prompts a closer look: 150 are sold and archived, 70 have expired and lost their freshness boost, 15 are stuck in draft, and 5 were suspended. The seller bulk re-lists the 70 expired items to bring them back into search and clears the drafts, lifting active listings without sourcing anything new. Because this card has no alert trigger, it is a context figure rather than a watchdog. Pair it with Active Listings to size the dormant pool and suspended listings to isolate policy issues. When the gap widens unexpectedly, Vortex Mind traces upstream causes such as a batch of expiries or a suspension wave, and Ask Viq answers plain-English questions like "how many of my listings are sitting expired or in draft right now?"

## Sibling cards merchants should reference together

| Card                                                                         | Why merchants reach for it                                   |
| ---------------------------------------------------------------------------- | ------------------------------------------------------------ |
| [`mer_listings_active`](/nerve-centre/kpi-cards/mercari/active-listings)     | Shows how many of the total are actually live and sellable.  |
| [`mer_total_revenue`](/nerve-centre/kpi-cards/mercari/total-revenue)         | Connects catalogue size to the sales it is generating.       |
| [`mer_return_rate`](/nerve-centre/kpi-cards/mercari/return-rate)             | Helps weigh listing volume against post-sale quality issues. |
| [`mer_avg_review_rating`](/nerve-centre/kpi-cards/mercari/avg-review-rating) | Adds a quality lens to a growing catalogue count.            |

## Reconciling against Mercari

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

In the Mercari app, your listings area lets you filter by state such as active, sold, and so on. Adding the counts across all of those state tabs, including drafts and suspended items, should approximate this card's single total. Mercari does not always present one all-states number, so a manual sum is the reliable check.

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

| Reason                                                                                                                       | Direction | What to do               |
| ---------------------------------------------------------------------------------------------------------------------------- | --------- | ------------------------ |
| **Period boundary.** A listing created or deleted between refreshes will move the total at the next sync.                    | Variable  | Match the period range.  |
| **Time zone.** A listing created near midnight may register on a different day depending on the time zone.                   | Marginal  | Confirm time zone match. |
| **Filter scope.** Mercari views often default to a single state, so a tab-by-tab sum is needed to match an all-states total. | Variable  | Match filter settings.   |

**Cross-connector reconciliation:** If you cross-list to other marketplaces, compare catalogue counts per channel to spot items missing from Mercari. For divergence investigations, use Vortex Mind.

## Known limitations / merchant FAQs

**Q: How often does Total Listings update?**
It refreshes on the standard Vortex IQ data refresh, so new listings, sales, and expiries are reflected close to real time.

**Q: Why does my Mercari dashboard show a different number?**
Mercari usually shows listings filtered by a single state, so a quick glance undercounts. Summing every state tab, including drafts and suspended items, should bring the figures in line.

**Q: How is this different from Active Listings?**
Total Listings counts every listing in any state, while Active Listings counts only items currently live and sellable. The gap between the two is your dormant catalogue: sold, expired, draft, or suspended items.

**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

*Total Listings* 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.
