Total Catalog Items, Square Online

Total Catalog Items: the count of distinct items in your Square Catalog for the selected period. How to read it, why it matters, and how to act on it.

Metrics type: Supporting Metrics • Category: Ecommerce Platform

Total Catalog Items for the selected period.

At a glance

The headline count of distinct catalog items in your Square Catalog. This counts items (the parent product), not variations and not SKUs. A single “Linen Shirt” item with five sizes is one catalog item here, while the Total Item Variations card counts the five. It is the simplest health read on how big your assortment is.

What it counts	The number of ITEM objects in the Square Catalog. One item per product concept, regardless of how many variations (sizes, colours, formats) sit beneath it.
Items vs variations	Items are parents, variations are children. This card counts the parents. A 5-size shirt is one item and five variations. If you want the sellable-unit count, see Total Item Variations.
POS vs online scope	All catalog items, both channels. Square’s Catalog is one library shared by Square POS and Square Online. An item flagged present_at_all_locations or sold only in-store still counts here. Online visibility is governed separately by ecom_visibility; this card does not filter on it.
Currency / unit	Whole number (count of items). No currency.
Time window	RT (real time). The count reflects the latest state of your Catalog, not a historical slice.
Alert trigger	No alert. This is a reference health number, not a threshold-driven pulse. Sudden large swings are still worth investigating manually (a bulk import or a bad delete).
Roles	owner, operations
What it excludes	Archived or deleted items are not counted. Modifier lists, categories, taxes, and discounts are separate Catalog object types and are not items, so they are excluded.
Why it matters	Assortment size frames almost every other catalog-health card. Missing SKUs, online-only items, and POS-sellable-but-not-visible items are all percentages of this denominator.

Calculation

Calculated automatically from your Square Online data. See the At a glance summary above for what the metric tracks and the worked example below for a typical reading.

Worked example

A US homeware retailer on Square. One flagship store plus a Square Online storefront sharing one Catalog. The catalog health snapshot is reviewed on 14 Mar 26.

Catalog object type	Count	Counted by this card?
Items (parent products)	1,840	Yes, this is the card
Item variations (sellable units)	6,210	No, see Total Item Variations
Categories	42	No
Modifier lists (add-ons)	18	No
Discounts	11	No
Archived / deleted items	230	No
Total Catalog Items (this card)	1,840

Three things to notice:

1. Items are far fewer than variations. 1,840 items expand to 6,210 variations because most products carry size or colour options. If you reason about assortment using this card but operate on variations (inventory, pricing, SKUs), you will undercount your real workload. Pair with Total Item Variations.
2. Non-item Catalog objects are excluded by design. Categories, modifiers, and discounts all live in the Square Catalog but are not products. This card counts only ITEM objects, so it stays a clean assortment read.
3. Archived items drop off. The 230 archived products do not count. If a seasonal range was archived after the holidays, this number falls even though nothing was deleted. A large unexpected change is usually a bulk archive, import, or accidental delete, worth confirming in the Square Dashboard.

Sibling cards merchants should reference together

Card	Why pair it with Total Catalog Items
Total Item Variations	The sellable-unit count beneath these items. Items to variations ratio tells you how option-heavy your assortment is and frames inventory workload.
Items missing SKU	A subset of your catalog that cannot be reliably matched across channels or reports. Read as a percentage of this total.
Online-only SKUs	Items sold on Square Online but not in store. Helps explain why the catalog total differs from what your POS staff recognise.
Items POS-sellable but not online-visible	The opposite gap, items in the catalog and sellable in-store but hidden from web shoppers via ecom_visibility.
Top Products by Revenue	A large catalog with revenue concentrated in a handful of items signals long-tail dead weight worth pruning.
Out-of-Stock Items	How much of the assortment is currently unsellable. Catalog size frames the stockout picture.

Reconciling against Square

Where to look in the Square Dashboard:

Square Dashboard, Items & Orders, Items library. The item count shown at the top of the Items list is the closest match to this card. Make sure any category or location filters are cleared so you are looking at the full library, and note whether the dashboard is showing items or variations, the two views differ.

Other Square Dashboard views that look like the same number but aren’t:

• Items library, item count: this DOES match (with all filters cleared, items not variations).
• Items library showing variations: a larger number. This is the Total Item Variations figure, not this card.
• Online, Items: only the items visible to Square Online, a subset filtered by ecom_visibility. Smaller than this card.
• Categories view: counts categories, not items.
• Archived items: a separate filter. Archived products are excluded here, so including them in the dashboard inflates the comparison.

Why our number may legitimately differ from Square Dashboard:

Reason	Direction of divergence
Items vs variations. If the dashboard view is set to variations, it shows the larger sellable-unit count, not the item count.	Dashboard higher when showing variations
Active filters. A category or location filter left on the Items list narrows the dashboard count.	Dashboard lower with filters applied
Online-only filter. The Online, Items view filters by ecom_visibility, so it shows fewer than the full catalog.	Dashboard lower in the Online view
Sync lag. A bulk import or delete in Square may take a short cycle to reach our index.	Self-resolves within minutes

Cross-connector reconciliation:

Card	Expected relationship	What causes legitimate divergence
Square inventory vs marketplace listings	Listing count on a marketplace should track a subset of catalog items	If you sell the same catalog on a marketplace, the listing count should be at or below this number. A marketplace listing count higher than your catalog suggests duplicate or orphaned listings.
google_analytics.product-performance	GA4 product reporting sees only items that received web views	GA4 records products that web shoppers interacted with, not the full catalog. It is always a subset of online-visible items, never the full count.

The Square shared-catalog advantage: Square keeps one Catalog across POS and online, so this single item count covers your entire assortment regardless of where each product sells. On platforms where POS is a bolt-on, the in-store and online catalogs can diverge, making a single trustworthy item count harder to produce.

---

Known limitations / merchant FAQs

Does this count variations or just items? Just items, the parent products. A single shirt with five sizes is one catalog item here. If you want the count of sellable units (each size, each colour), use Total Item Variations. The two are easy to confuse because the Square Dashboard can show either depending on the view.

Are in-store-only items included? Yes. The Square Catalog is one shared library across POS and Square Online. An item that is sold only in-store still counts here. Whether an item appears on the web is controlled separately by its ecom_visibility setting, which this card does not filter on. To see the online subset, use the Online, Items view in Square.

Do archived or deleted items count? No. Archived and deleted items are excluded. This means a large seasonal archive can lower the number even though nothing was permanently removed. If the count drops unexpectedly, check the archived filter in the Square Items library to confirm whether items were archived rather than lost.

Why is there no alert on this card? Catalog size is a slow-moving reference number, not something that needs minute-by-minute monitoring. It is here so other catalog-health cards (missing SKUs, online-only items, stockouts) have a denominator to be read against. A sudden swing is still worth a manual look, usually a bulk import or an accidental delete.

Do categories, modifiers, and discounts count? No. Those are separate Catalog object types. Square’s Catalog holds items, item variations, categories, modifier lists, taxes, and discounts as distinct types. This card counts only ITEM objects, so add-ons and pricing rules are excluded.

My catalog count jumped overnight, what happened? The two usual causes are a bulk import (a CSV upload or a new integration writing items) and a bulk archive or delete. Check the Square Items library and any connected catalog-sync tools. Because this is a real-time count, it reflects the change immediately rather than waiting for a period to close.

---

Tracked live in Vortex IQ Nerve Centre

Total Catalog Items is one of hundreds of KPI pulses Vortex IQ tracks across Square Online 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 or book a demo to see this metric running on your own data.