Item
An item is a distinct good or service that a business buys, sells, stocks or manufactures, identified by a unique code.
Also called Product · SKU · Material · Article · Part
Why it exists
Because a business needs to say exactly what it bought, sold or holds, in a way that means the same thing to the warehouse, the accountant and the customer.
What it means to the business
The item master is where the business's catalogue meets its inventory and its accounts. Its structure decides what questions can be answered — margin by category, stock by location, movement by variant — because reporting can only slice along the lines the master already draws. Deciding what constitutes one item is the highest-leverage and least-glamorous decision in an implementation.
Draft. Being defined. Not transactable.
State 1 of 4
Item sold via Sales Order.
Open Sales OrderA code like RM-STL-10MM-BLR reads well until steel moves warehouse or the grade changes. Attributes belong in fields that can be filtered and changed; the code should be an identifier and nothing else.
Rules that must hold
- An item code is unique and permanent. Reusing a retired code makes every historical report about that code ambiguous.
- An item is either stocked or it is not, and that decision determines whether it has a stock ledger at all.
- Unit of measure is intrinsic to the item. Changing it after transactions exist invalidates every quantity previously recorded.
What commonly goes wrong
Items get created ad hoc by whoever needs one, and the same physical thing acquires three codes with slightly different descriptions. Stock splits across them, reordering fires on one while another sits idle, and the fix is not a merge script but a rule about who is allowed to create an item and what they must check first.
Edge cases
- Items that are sometimes stocked and sometimes drop-shipped, where the same code has a stock ledger for one flow and not the other.
- Batch- or serial-tracked items, where identity is per-unit rather than per-code and quantity alone is insufficient.
- Service items with no stock at all, which still need pricing, tax treatment and an HSN/SAC code.
- Items whose specification changes while the code stays — a supplier reformulation that nobody records is invisible until a customer notices.
How ERPNext models it
| DocType | Note |
|---|---|
| Item | `is_stock_item` decides whether a stock ledger exists at all — the single most consequential flag on the record. |
| Item Variant | Attribute-driven variants of a template. The correct answer to size/colour, and to most 'we need 40 similar items' requests. |
| UOM Conversion Detail | Lets an item be bought in cartons and sold in pieces without two item records. |
Last reviewed 2026-08-14
Machine-readable versionWe implement this for a living — that’s where the mistakes above come from. See the service or request a discovery briefing