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 |
- 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.
- 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
ITEMobjects, so it stays a clean assortment read. - 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.
| 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 |
| 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. |
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 itsecom_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.