General settings

The General tab is the first tab of a machine’s detail view. It holds the machine-level settings and the tools that apply to the whole machine.

The General information card

The General information card shows three fields:

• Technical name — the internal identifier, e.g. order.state.
• Name — the readable display name.
• Initial state — the state an entity starts in when it first enters this machine.

The view opens read-only. A warning banner sits above the card:

Be careful when editing state machines. Incorrect changes to states or transitions can negatively affect system behavior, including order processing and payment flows.

Edit mode

1. Click Edit in the toolbar to unlock the fields.
2. Change the Name, the Initial state, or — on custom machines — the Technical name.
3. Click Save to apply, or Cancel to discard.

On core state machines the Technical name stays locked even in edit mode, with a note explaining it cannot be changed. The Name and Initial state can still be adjusted.

Validate

The Validate button in the toolbar checks the machine for common problems — a missing initial state, states with no transitions, states that cannot be reached, and duplicate transitions. The result is shown as a notification. See Validation for what each check means.

Deleting a state machine

You can delete a machine from the context menu on the State Machines list.

Two safeguards apply:

• Core machines cannot be deleted. The order, payment, delivery and transaction machines are protected; attempting to delete one is refused.
• Machines still in use cannot be deleted. If any of the machine’s states are still referenced by real entities such as orders, the deletion is blocked and a message explains why.

When a machine can be deleted, a confirmation dialog appears first — deleting a machine also removes all of its states and transitions.

Next steps

• Managing states
• Core state machines
• Validation