Components — User Guide
Module: Fixed Equipment
Audience: IT administrators, asset managers, hardware technicians
Version: 1.0.0
Last updated: 2026-07-22
Overview
Components is where you track quantity-based parts — RAM modules, hard drives, batteries, and similar items installed into parent assets. Each component record has a total quantity, a minimum quantity warning level, and a remaining (available) count. When you check out components, you assign a quantity to a specific asset (for example, installing two RAM sticks into a laptop).
Use this screen for parts that belong inside or attach to tagged equipment. For loaned peripherals, use Accessories. For supplies handed to staff, use Consumables.
Prerequisites
| Task | Permission |
|---|---|
| View the component list and detail ledger | Fixed Equipment → Components → View (or View own) |
| Add components, check-out from list or detail | Fixed Equipment → Components → Create |
| Edit a component | Fixed Equipment → Components → Edit |
| Delete a component | Fixed Equipment → Components → Delete |
Setup before adding components:
- Settings → Categories — create at least one category with type Component.
- Settings → Locations — optional default storage location.
- Assets — parent assets must exist before you can check out components to them.
Step-by-step: View and filter components
- Go to Fixed Equipment → Components.
- Use the filter dropdowns:
- Category
- Location
- Review the table columns: name, serial, category, total quantity, remaining (available), minimum quantity, location, order number, purchase date, and purchase cost.
Expected result: Active components with availability at a glance. Names and remaining counts appear in red when stock falls below the minimum quantity.
Step-by-step: Add a component
- On the Components page, click Add.
- Complete the form:
- Component name (required)
- Category (component-type category)
- Quantity (required — total units on hand)
- Minimum quantity — warning threshold for low stock
- Serial — optional batch or part serial reference
- Location, Order number
- Purchase cost, Purchase date
- For sell + Selling price (optional)
- Upload image (optional)
- Click Submit.
Expected result: The component appears in the list with remaining count equal to the quantity entered.
Step-by-step: Edit a component
- In the list, open the row menu and click Edit.
- Update fields and click Submit.
Tip: If units are checked out to assets, verify totals manually before reducing quantity — the system does not always block reductions below checked-out amounts.
Step-by-step: Check out components (from list)
Install or assign a quantity of components to a parent asset.
Before you start: At least one unit must be available.
- In the last column, click Check-out on the row.
- Confirm the component name.
- Select the target Asset (parent equipment).
- Enter Quantity (how many units to install or assign).
- Add Notes if needed.
- Click Check-out.
Expected result: Remaining count decreases by the quantity checked out. The assignment appears on the component detail page and on the parent asset's Components tab.
Step-by-step: Open component details (checkout ledger)
- In the list, click View on a row.
- The detail page lists active checkouts: target asset (or customer), quantity, notes, checkout date.
- To check out more units, click Check-out in the page header (when units remain available).
- To return units, click Check-in on a ledger row, enter the quantity to return (can be partial), add notes, and submit.
Expected result: Returned quantities increase the remaining count. Partial returns leave the remainder checked out.
Step-by-step: Bulk upload
- On the Components page, click Bulk upload.
- Download the template, fill in rows, and upload the spreadsheet.
Validate that categories exist in Settings before importing.
Field reference
| Field | Required | Description |
|---|---|---|
| Component name | Yes | Display name for the part type |
| Quantity | Yes | Total units in inventory |
| Minimum quantity | No | Low-stock warning; UI highlights when remaining falls below |
| Serial | No | Batch or part serial reference (stored as series) |
| Category | No | Component-type category |
| Location | No | Default storage location |
| Purchase cost | No | Unit cost in base currency |
| Purchase date | No | When stock was acquired |
| Order number | No | PO or invoice reference |
| For sell | No | Marks item for commerce flows |
| Image | No | Thumbnail shown in list |
Common issues
| Symptom | Likely cause | What to do |
|---|---|---|
| Check-out button disabled | No available units | Check in units from the detail page |
| Checkout fails | Quantity exceeds available stock | Lower the checkout quantity |
| Red remaining count | Stock below minimum quantity | Reorder or adjust minimum threshold |
| No Add button | Missing Create permission | Ask admin to grant Components → Create |
| Cannot find target asset | Asset not created or inactive | Add the parent asset under Assets first |
| Partial return needed | Full check-in not required | Enter a quantity less than checked out on check-in |
Related features
- Assets — parent equipment; Components tab shows installed parts
- Locations — view components stored at a specific site
- Accessories — loaned peripherals (staff checkout)
- Consumables — supplies issued to staff
- Settings → Categories — define component categories