Skip to main content
TWICE uses two related concepts on its core entities — Status and State — to track different aspects of where something is in its journey.

​
Quick Summary

Each entity (stock item, order, listing) defines its own status and state values — there is no universal Status that applies to everything. The table below shows what each entity uses.

​
Status and State by Entity

  • Status controls whether the item can be assigned to new orders
  • State reflects whether the item is at hand or with a customer
Read more: Stock Item Status · Stock Item State

​
Why two dimensions?

Status answers a slow-changing question: “What kind of thing is this right now in its lifecycle?” State answers a fast-changing question: “What’s happening with this thing operationally?” Keeping the two separate lets you reason about each independently. For example, a stock item with status In use can have state Out (rented to a customer) — both are valid and meaningful at the same time. You can:
  • Filter by status to clean up your workspace (hide Sold items, show only In use)
  • Filter by state to make operational decisions (which items are currently Out, which are In and ready for a new order)

​
Worked Examples

​
Stock Item

A bike rental shop has the same bike go through these combinations over time:

​
Order

Stock Item Status

In use, Out of use, Lost, Sold

Stock Item State

In vs Out — physical location

Order Lifecycle

Open / In progress / Closed plus payment & fulfillment

Listings

Publishing status: Draft / Published / Archived