
Inventory > Stock Items > [Item] > General
Definition
describes where an item sits in its operational lifecycle. It controls whether the item counts toward availability and can be assigned to orders. Three Status Values:
The
status field on the Article resource holds exactly these three values. There is no Lost or Sold status: Take an item out of use says what to do instead.
Status is independent from State (In or Out, where the item physically is).
Where do I use it?
See and change a stock item’s status in the Status card on its General tab. The status also shows as a chip next to the item’s name: Active (green), Draft (orange), Inactive (red). Set a stock item inactive walks through changing it. Status affects:- Availability calculations: only Active items count toward Available To Sell (ATS). Availability queries join stock items on
status = 'active'. - Order fulfillment: only Active items can be assigned to new orders.
- Listings: a listing offers only Active stock items, whether it sells, rents or books them.
- Reports: Reports → Inventory by status counts your stock items per status.
Key properties
When to use each status
Active
The default for any item ready to participate in operations. New Stock Items are created withstatus: 'active' unless you specify otherwise.
- Rentals or sales available now.
- Items in working condition.
- Items kept on shelves or in fleet circulation.
Inactive
Use Inactive when an item should be excluded from operations indefinitely.- Under long-term repair or refurbishment.
- Retired but kept on record.
- Quarantined pending inspection.
- Lost, stolen, or written off.
- Demo or test units not for customer use.
Draft
Draft marks a stock item whose registration has not finished. Registering from photos creates a draft to attach the photos to, and Register Stock Items turns it into an Active or Inactive stock item, whichever Entry status says. Register from photos walks through it. In the photo registration dialog, Cancel deletes the draft. Closing the dialog any other way leaves the draft in place. The Status card never offers Draft, so a registered stock item cannot go back to it. On a draft, the card offers Active and Inactive but saves neither.Take an item out of use
Choose by how long the item is out and what should happen to the orders it is already on. Inactive is one of three ways to stop new orders getting it.
Reserve the item for a known window, such as a service. Set it Inactive for an open-ended pause in which a running rental still ends on its own. Archive it when it is leaving for good, and unarchive it if it comes back.
Selling a unit changes nothing on its stock item: there is no Sold status, and the status stays what it was. The sale holds the unit with no end date, so once sold it never counts toward availability again, whatever its status.
A sold unit stays in Inventory → Stock items until you archive it, and archiving keeps the sale’s hold and the order that sold it.
Set a lost or stolen item Inactive. To keep the reason on its record, add a note, and record a cost to write off its value.
Status transitions
- Draft → Active: the normal outcome of registration.
- Active ↔ Inactive: reversible, but the bookings released by going Inactive stay released. Reactivating an item makes it count toward ATS again for any range it is not already committed to. No history is lost in either direction.
- → Draft: not offered in the admin once the item is registered.
What changes immediately
When you set an Active item to Inactive:- Item drops out of ATS within the next availability read.
- Item is excluded from new order assignment.
- Its upcoming order bookings are released, and each order shows a conflict until you give it another unit. A unit already out with a customer stays on its order until it is returned, and a store reservation keeps its hold.
- Ledger, events, media, and documents stay intact.
- Item starts counting toward ATS for any range it is not already committed to.
- Item becomes eligible for new orders again.
- Released bookings are not restored.
- No history is lost.
Lifecycle
Creation
New Stock Items default tostatus: 'active'. You can override at creation:
- Set
status: 'inactive'when importing items that still need inspection. They stay out of availability until you flip them. status: 'draft'is normally set by the registration flow, not by hand.
Modification
Change status in the Status card on the item’s General tab, on several items at once with bulk edit, or withPUT /articles/:id and {"status": "inactive"}. The list endpoint’s status filter takes one of the three values. See the API reference for the articles endpoints.
Deletion
Delete a stock item only once it is archived, from Settings → Archived assets. Deleting cannot be undone from the admin, and it frees the item’s codes for another stock item. Delete a stock item walks through it, and Archiving and Deletion compares it with archiving.FAQs
What's the difference between Status and State?
What's the difference between Status and State?
- Status (Active / Inactive / Draft): operational lifecycle, set manually.
- State (In / Out): physical location, set automatically by fulfillment.
How do I record a lost or sold item?
How do I record a lost or sold item?
Set a lost item Inactive. A sold item needs no status change, because the sale’s hold already keeps it out of availability. Read more: Take an item out of use.
How do I find all my Inactive items?
How do I find all my Inactive items?
Open Reports → Inventory by status for a count per status. The Stock items table cannot filter by status, so to list the inactive items themselves, call the list endpoint with its
status filter set to inactive.Can an Inactive item still have open orders?
Can an Inactive item still have open orders?
Only a unit that was out with a customer when you set it Inactive. It stays on its order until it is returned, and the order line shows a Unit inactive chip with its dates locked. Every other upcoming booking is released and shows as a conflict to resolve.
Can I bring an Inactive item back?
Can I bring an Inactive item back?
Yes. Change the status back to Active. All historical data is preserved, but the order bookings released earlier are not restored. This is useful for items back from repair or recovered after a loss.
Is Draft shown in the UI?
Is Draft shown in the UI?
Yes. A draft item shows an orange Draft chip in its header. Drafts come from unfinished registrations. Once registered, the admin does not offer returning an item to Draft.
Developer Reference
Stock item status is read and updated via thearticles endpoints.
API: Articles
Open the endpoint in the API reference.
Related articles
Stock Items
Full Stock Item model and lifecycle
Stock Item State
In vs Out, the physical location dimension
Stock Item Events
Reservations, notes, activity log
Workflows
Automate inventory operations