Total Item Variations for the selected period.
At a glance
The count of distinct item variations in your Square Catalog. Variations are the sellable units beneath each item, each size, colour, or format that a customer actually buys and that inventory is tracked against. A “Linen Shirt” item with five sizes contributes five variations here. This is the true scale of your operation: pricing, SKUs, and inventory all live at the variation level.
| What it counts | The number of ITEM_VARIATION objects in the Square Catalog. Each variation is one sellable unit (a specific size, colour, or format) with its own price and SKU. |
| Variations vs items | Variations are children, items are parents. This card counts the children. A 5-size shirt is one item and five variations. Every item has at least one variation, even a product with no options has a single default variation. |
| POS vs online scope | All variations, both channels. Square’s Catalog is shared by Square POS and Square Online. A variation sold only in-store still counts. Online visibility is governed by ecom_visibility on the parent item; this card does not filter on it. |
| Currency / unit | Whole number (count of variations). No currency. |
| Time window | RT (real time). The count reflects the latest state of the Catalog. |
| Alert trigger | No alert. This is a reference scale number. A large unexpected swing (a bulk import, a deletion, or a variation explosion from a new option set) is worth a manual look. |
| Roles | owner, operations |
| Why it is the operational number | Inventory on-hand counts, SKUs, and prices are all per variation, not per item. This card is the real size of your inventory and pricing surface, which is why it usually dwarfs the item count. |
| What inflates it | Wide option matrices. A shirt in 6 sizes and 8 colours is 48 variations from a single item. A few option-heavy products can balloon this count. |
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 apparel retailer on Square. One flagship store plus a Square Online storefront sharing one Catalog. The catalog scale snapshot is reviewed on 14 Mar 26.| Item (parent) | Options | Variations from this item | Has SKU on all |
|---|---|---|---|
| Linen Shirt | 6 sizes x 4 colours | 24 | Yes |
| Wool Scarf | 5 colours | 5 | Yes |
| Canvas Tote | 1 (no options) | 1 | Yes |
| Leather Belt | 8 sizes | 8 | No (2 missing) |
| … 1,836 more items | mixed | 6,172 | mixed |
| Total Item Variations (this card) | 6,210 |
- A handful of option-heavy items drive most of the count. The Linen Shirt alone is 24 variations from one item. Apparel and footwear catalogs expand far more than the item count suggests, which is why this card (6,210) is more than three times the Total Catalog Items count (1,840). Plan inventory and pricing work against this number, not the item count.
- Every item has at least one variation. Even the Canvas Tote, with no options, is one variation, the default. So this count can never be lower than the item count. If it ever is, something is wrong with the catalog data.
- Missing SKUs hide at the variation level. The Leather Belt has two sizes with no SKU. Missing SKUs are counted per variation, so they are a slice of this total, not the item total. Pair with Items missing SKU to find and fix them.
Sibling cards merchants should reference together
| Card | Why pair it with Total Item Variations |
|---|---|
| Total Catalog Items | The parent-product count. Variations divided by items shows how option-heavy your assortment is and frames inventory workload. |
| Items missing SKU | Missing SKUs are counted per variation. Read this card as the denominator for the SKU-coverage gap. |
| Out-of-Stock Items | Stockouts are tracked at the variation level. This count frames how much of your sellable surface is currently unavailable. |
| Low Stock Products | Low stock is per variation too. A large variation count with many low-stock units signals a replenishment squeeze. |
| POS to Online Inventory Drift Alert | Drift is checked per variation per location. This count frames the number of parity surfaces being monitored. |
| Online-only SKUs | Variations sold online but not in store. A subset of this total worth understanding for channel strategy. |
Reconciling against Square
Where to look in the Square Dashboard: Square Dashboard, Items & Orders, Items library. Switch the view to show variations (or export the item library, which lists one row per variation). The variation count is the closest match to this card. Clear any category or location filter so you are looking at the full catalog. Other Square Dashboard views that look like the same number but aren’t:- Items library exported as a CSV (one row per variation): this DOES match (full catalog, all variations).
- Items library item count: the parent-item count, the smaller Total Catalog Items figure, not this card.
- Online, Items: only variations on items visible to Square Online, a subset filtered by
ecom_visibility. Smaller than this card. - Inventory management: lists variations that track stock, which can be fewer than all variations if some are not inventory-tracked.
| Reason | Direction of divergence |
|---|---|
| Items vs variations view. If the dashboard is showing items, it reports the smaller parent count, not variations. | Dashboard lower when showing items |
| Active filters. A category or location filter narrows the dashboard count. | Dashboard lower with filters applied |
| Inventory-tracked subset. The Inventory management view lists only stock-tracked variations, which can be fewer than the full catalog. | Dashboard lower in the inventory view |
| Sync lag. A bulk import or delete 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 | Marketplace listings map to variations, not items | A marketplace usually lists per sellable unit (per variation). Its listing count should track a subset of this number; a mismatch points to listings that no longer map to a live Square variation. |
google_analytics.product-performance | GA4 sees only variations that received web activity | GA4 records products web shoppers viewed or bought, usually reported at the item level and only for online-visible products. It is always a subset, never the full variation count. |
Known limitations / merchant FAQs
What is the difference between a variation and an item? An item is the parent product (a “Linen Shirt”); a variation is a sellable unit beneath it (the medium in sand). Inventory, price, and SKU all live on the variation, not the item. This card counts variations, so it is the operational scale of your catalog. The parent-product count is Total Catalog Items. Why is this number so much bigger than my item count? Because option-heavy products multiply. A shirt in 6 sizes and 4 colours is 24 variations from a single item. Apparel, footwear, and food-with-options catalogs expand dramatically. The ratio of variations to items is a useful signal of how complex your assortment is to manage. Does every item have a variation? Yes. Even a product with no options has one default variation in Square. That is why this count can never be lower than the item count. If you ever see variations below items, the catalog data has a problem worth investigating. Are in-store-only variations included? Yes. The Square Catalog is shared across POS and Square Online, so a variation sold only in-store still counts. Online visibility is set per item viaecom_visibility, which this card does not filter on. To see only the online-visible subset, use the Online, Items view in Square.
Why is there no alert on this card?
Catalog scale is a slow-moving reference number, not a threshold pulse. It is here so inventory, SKU, and stockout cards have a denominator to be read against. A sudden swing usually means a bulk import, a delete, or a new option set, all worth a manual look rather than an automated alert.
Should I worry about a very high variation count?
Not on its own, but it is a flag to check for dead weight. Variations that never sell still carry inventory, pricing, and listing overhead. Pair this card with Top Products by Revenue to see how concentrated sales are, and consider pruning long-tail variations that add complexity without revenue.