State Machine Manager | Order Statuses Manager

About the Extension

State Machine Manager gives you full control over Shopware's state machines directly from the administration panel. By default, Shopware does not provide any UI for managing states or transitions — they can only be configured through database migrations. This plugin fills that gap with an intuitive admin module.

Import & Export

Move a state machine configuration between shops as a JSON file instead of rebuilding it by hand:

• Pick what you export — Choose the state machines, and within each one the transitions you want to carry over
• See before you write — The import wizard shows each machine on a diagram, marking in green what the shop already has and in blue what will be created
• Conflicts up front — Name clashes, missing endpoints and core machines are reported before anything is written, not after
• Additive only — The import never deletes and never overwrites what exists; running it twice changes nothing the second time
• All shop languages — Names travel in every language of the source shop, and the wizard asks for any name still missing in the target shop's default language
• Layout travels too — Diagram positions are carried with the machine and keyed by technical name, so the arrangement survives the move

Visual Diagram Editor

An interactive SVG-based flow diagram lets you see the entire state machine at a glance:

• Drag & drop — Rearrange states freely on the canvas
• Connect states — Drag from a port on one state to another to create transitions
• Snap-to-port — Visual feedback with green/red highlighting, telling you before you drop whether the transition can be created
• Readable routing — Connectors run at right angles, keep clear of the cards they pass, and are pulled apart where two would otherwise share a line
• Labels on the line — Each transition carries its action name on its own path, placed so it never covers a turn or another label
• Auto-layout — Arranges the machine from its initial state and spreads connectors across the card edges instead of crowding one side
• Pan & zoom — Navigate large diagrams by dragging anywhere on the canvas

State Management

Full CRUD for states within each state machine:

• Add, edit and delete states with technical name and display name
• Set any state as the initial state, with a confirmation step
• Search and filter states by name
• Delete protection — states in use by orders, transactions or deliveries cannot be deleted

Transition Management

Full CRUD for transitions (allowed state changes):

• Define which action leads from one state to another
• Multiple transitions between the same states with different action names are supported
• Self-loop transitions (same source and target) are supported
• Duplicate detection prevents creating identical transitions
• Search and filter transitions by action name or state names

Validation

A built-in validation tool checks your state machine configuration for potential issues:

• Missing initial state
• Orphaned states with no transitions
• Unreachable states (no inbound transitions)
• Duplicate transitions

History

View the complete transition history for each state machine — when each transition happened, which entity was affected, who triggered it, and what the source and target states were.

Safety

Core state machines (order, payment, delivery) are protected from deletion. All changes go through validation before being applied, and the import re-checks the shop server-side before writing anything.