Skip to main content
Version: 1.0.0

Order Statuses

Order statuses control how order progress is communicated in admin, automation, and customer notifications.

Where to manage statuses​

Open Yui → Sales → Order Statuses.

From this screen you can:

  • Create a new status
  • Edit existing status
  • Duplicate status
  • Reorder statuses
  • Set default status
  • Toggle visibility
  • Delete removable statuses

Status fields explained​

When creating or editing a status:

  • Label: human-readable name shown in admin.
  • Handle: internal identifier used by logic and integrations.
  • Description: guidance for operators.
  • Color: visual marker in status UI.
  • Metadata (JSON): optional integration payload.

Important switches​

  • Mark as default: used when a new order is created.
  • Notifies customer: can drive customer status-email behavior.
  • Fulfills the order: marks status as fulfillment/completion context.
  • Visible: shows/hides status from status picker.
  • Archive status: keeps it for history while limiting active usage.

System statuses​

Some statuses are system defaults.
For these statuses, certain fields (like handle and advanced switches) can be restricted to protect core lifecycle behavior.

How admins should work with statuses​

  1. Keep status names operational and unambiguous.
  2. Use one clear status for each lifecycle step.
  3. Avoid deleting statuses that are already used in reporting or flows.
  4. Prefer hiding/archiving over deletion when historical data must remain interpretable.

Permissions​

Access is split by permission:

  • yui:orders:statuses:view
  • yui:orders:statuses:create
  • yui:orders:statuses:edit
  • yui:orders:statuses:delete

Give create/edit/delete only to advanced admins, because status changes can affect automations and customer communication.