Item attributes and variants in Business Central

How Business Central handles product variations — variants for stock-keeping, attributes for searching, and where the model fits and where it doesn't.

Updated 2025-10-02

Business Central handles product variation through two related but distinct concepts: variants (which create stock-keeping differences) and attributes (which describe and filter without affecting stock). Knowing which is which avoids most variant-related implementation mistakes.

Variants. An item with variants has one item number but multiple stock-keeping codes — typically size, colour, or trim. Each variant is a row of the Item Variant table, and inventory, transactions, and prices can be specific to it. Variant codes are short (10 characters) and intended for the production / stock-keeping dimension that matters operationally: a shirt with sizes S/M/L/XL or a paint with colours Red/Blue/Green. Variants share the underlying item card (description, base UoM, costing method) so they're a lightweight way to multiply SKUs without multiplying master data.

Variants and pricing. Sales and purchase prices can be set per variant, and stock can be reserved per variant, but planning runs at the item-and-variant level so MRP works correctly.

Attributes. Item attributes are descriptive properties — material, country of origin, certification, weight class — used for filtering, search, and reporting. Attributes are key-value pairs with predefined types (Option, Text, Date, Number), and they're attached to an item or an item category. They do not create stock-keeping differences.

Item categories. A hierarchical item category holds default attributes — set "Country of Origin" on the "Imported Bicycles" category and every item in that category inherits the attribute. Categories also default posting groups, item tracking, and reordering policies, so they're the most efficient way to manage large catalogues.

When variants fall short. Variant codes are flat (a single dimension). For two-dimensional configurations — sizes and colours — companies typically encode both into the variant code (L-RED, L-BLU, M-RED, M-BLU) or use ISV apps that add true matrix variants. For configurable products with engineered options, you need a separate product configurator add-on or step up to Supply Chain Management.

Variants and item ledger. Item ledger entries store the variant code, so all inventory transactions, costing, and reporting break down per variant correctly. Inventory valuation rolls up to the item but can be reported by variant.

A common mistake. Using variants for marketing taxonomy (brand, season, range). That belongs in attributes. Variants are for things that change stock.

Related guides