Help Center/Plan Configurator & Compensation Models/How to submit a plan version for review
Plan Configurator & Compensation Models•Last updated: 2026-10-20•4 min read

How to submit a plan version for review

Submit a draft so the Studio validates it. Blocking findings stop it; warnings must be acknowledged one by one before it can move to review.

Have questions or need step-by-step guidance on this topic?

Ask AI Copilot

Step-by-Step Procedure

1

Open the version

Select the plan and the version. Read the "Validation findings" list: each line shows a level (BLOCKING, WARNING or INFO), a code and a message.

2

Fix every BLOCKING finding

Blocking findings must be fixed in the definition or the composer, then saved. The version cannot reach review while one remains.

3

Acknowledge each WARNING you accept

For a WARNING on an editable version a checkbox labelled "acknowledge" appears. Tick it only after you have understood the warning.

💡 Pro Tip: An unacknowledged warning sends the version back to FAILED VALIDATION with the reason "Acknowledge warnings".
4

Click "Submit for review"

The Studio sets the state through VALIDATING and recomputes findings and the content hash. The message "Submitted: see the findings and state." appears. If everything passes, the state becomes IN REVIEW.

5

Check the required approvals

Under "Approvals required" the panel lists the categories still "pending". A financial version is flagged "financial · dual approval" and needs FINANCE, COMPLIANCE and PLAN_APPROVER; any other version needs PLAN_APPROVER.

Expected Operational Outcome

The version is IN REVIEW with a list of pending approvals, or it is FAILED VALIDATION with a clear reason you can fix and resubmit.

Troubleshooting & Failure Modes

Symptom: State is FAILED VALIDATION after submitting
Likely Cause: A blocking finding exists or a warning was not acknowledged.
Resolution: Read "stateReason" shown in amber and the findings, fix or acknowledge, then submit again.
Symptom: "Submit for review" is missing
Likely Cause: The version is not editable or you lack plan.edit.
Resolution: Check the state badge and your roles in "Your access".

Was this guide helpful?

Help us refine our platform documentation