> For the complete documentation index, see [llms.txt](https://docs.notionapps.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.notionapps.com/automation/troubleshooting-automation/validation-error-catalog.md).

# 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.](https://content.gitbook.com/content/5ZqDXcVVffWUqEIZVhmn/blobs/J4yDDbTlZPwWWYg09Of3/assets/approval-management/maker-builder/04-procurement-approval-desk-validation-ready.jpg)

*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.