Skip to main content
Stock item status on the General tab

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.
Read more: Stock Items: General Tab.

Key properties

When to use each status

Active

The default for any item ready to participate in operations. New Stock Items are created with status: '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.
Setting an item Inactive opens a confirmation dialog that lists the order bookings it releases. Take an item out of use says which holds go and which stay. Reserve the item instead when you know when it will be back.

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.
Every status change is recorded in the item’s activity log as an update event carrying the changed value and the user who made it, so you can reconstruct when each change happened.

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.
When you set an Inactive item to Active:
  • 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 to status: '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 with PUT /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

  • Status (Active / Inactive / Draft): operational lifecycle, set manually.
  • State (In / Out): physical location, set automatically by fulfillment.
An Active item can be Out (with a customer). An Inactive item can be In (in your storage, off duty). The two are independent. Read more: Stock Item State.
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.
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.
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.
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.
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 the articles endpoints.

API: Articles

Open the endpoint in the API reference.

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