🚨Validation Error Catalog

Validation Error Catalog

Use this catalog when validation reports a blocker or warning. Fix the first blocker, then validate again.

Validation ready state.

Validation ready state.

Severity guide

Severity	Meaning	What to do
Blocker	The workflow is not ready to publish or demo.	Fix before testing with customers.
Warning	The setup may work, but there is risk.	Read the message, decide, then live test.
Info	Helpful context.	Review if relevant.

Common validation messages

Message	Plain-language meaning	Fix	Retest
Submit button is not connected to a workflow	The user action does not start the route.	Connect When this happens to the real submit action.	Create a fresh request and click Submit.
Submitted status does not match	The app writes one status and the workflow listens for another.	Match the exact status value.	Submit from the app, not the backend.
Recipient cannot be resolved	The workflow cannot find who should receive the work.	Use a real role, team, owner, requester, reviewer, or user field.	Preview as recipient.
Destination screen missing	The work has nowhere visible to appear.	Add or connect Decision, Work Queue, Conversation, Notification Center, or Workflow Status.	Confirm item appears.
Screen permission blocks recipient	The recipient exists but cannot access the screen.	Update screen visibility and role permissions.	Preview as least-privileged role.
Message route missing	The workflow cannot notify the user.	Add recipient message and delivery destination.	Trigger workflow and check Notification Center or Conversation.
Decision action not mapped	The reviewer can click but the result will not update correctly.	Map approve, reject, and request changes outcomes.	Complete a decision and check source status.
Exception path missing	Failures may be silent.	Add Exception Resolution.	Trigger a controlled failure and confirm it appears.
Repair required	A generated piece is missing or disconnected.	Read the validation message, run Repair setup, validate again.	Create a fresh test request.

What to capture for support

If you still need help, capture the app name, workflow name, source screen, test record title, starting action, expected destination, recipient role, validation result, and screenshot of the visible failure.