> ## 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 Item Variations, Square Online > Total Item Variations: the count of sellable item variations in your Square Catalog. How to read it, why it matters, and how to act on it. **Card class:** [Non-Hero](/nerve-centre/overview#card-classes-explained) • **Category:** [Ecommerce Platform](/nerve-centre/connectors#connectors-by-type) > 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](/nerve-centre/kpi-cards/square-online/total-catalog-items) 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** | | Three things to notice: 1. **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](/nerve-centre/kpi-cards/square-online/total-catalog-items) count (1,840). Plan inventory and pricing work against this number, not the item count. 2. **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. 3. **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](/nerve-centre/kpi-cards/square-online/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](/nerve-centre/kpi-cards/square-online/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](/nerve-centre/kpi-cards/square-online/items-missing-sku) | Missing SKUs are counted per variation. Read this card as the denominator for the SKU-coverage gap. | | [Out-of-Stock Items](/nerve-centre/kpi-cards/square-online/out-of-stock-products) | Stockouts are tracked at the variation level. This count frames how much of your sellable surface is currently unavailable. | | [Low Stock Products](/nerve-centre/kpi-cards/square-online/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](/nerve-centre/kpi-cards/square-online/pos-online-inventory-drift-alert) | Drift is checked per variation per location. This count frames the number of parity surfaces being monitored. | | [Online-only SKUs](/nerve-centre/kpi-cards/square-online/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](https://squareup.com/dashboard). 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](/nerve-centre/kpi-cards/square-online/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. **Why our number may legitimately differ from Square Dashboard:** | 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 | **Cross-connector reconciliation:** | Card | Expected relationship | What causes legitimate divergence | | -------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | [Square inventory vs marketplace listings](/nerve-centre/kpi-cards/square-online/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`](/nerve-centre/kpi-cards/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. | **The Square shared-catalog advantage:** Square tracks inventory, price, and SKU at the variation level in one Catalog across POS and online. This single variation count is therefore the true operational scale of your business in one number, in-store and web combined. On platforms where POS is a separate product, variation counts can diverge between channels, making one trustworthy number harder to get. ***
Same-metric documentation cross-reference (for agencies running multiple platforms) The same definition of variations, or SKUs / variants on other platforms, lives elsewhere in the docs. This is **not a reconciliation**, your Square catalog has no parallel catalog on Shopify or BigCommerce. These links exist so agencies running multi-platform client books can navigate between equivalent metrics. * [`shopify.total-variants`](/nerve-centre/kpi-cards/shopify/total-variants) * [`bigcommerce.total-variants`](/nerve-centre/kpi-cards/bigcommerce/total-variants)
## 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](/nerve-centre/kpi-cards/square-online/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 via `ecom_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](/nerve-centre/kpi-cards/square-online/top-products-by-revenue) to see how concentrated sales are, and consider pruning long-tail variations that add complexity without revenue. *** ### Tracked live in Vortex IQ Nerve Centre *Total Item Variations* 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](https://app.vortexiq.ai/login) or [book a demo](https://www.vortexiq.ai/contact-us) to see this metric running on your own data.