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

How to retire or archive a plan version

Retire a live, approved or scheduled version so it takes no new participation (history and accrued obligations are kept), or archive a finished version to tidy the library.

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

Ask AI Copilot

Step-by-Step Procedure

1

Select the version

Open the plan and click the version button.

2

Retire a live, approved or scheduled version

Enter a "retirement reason" and click "Retire". The state becomes RETIRED and, if it was the live version, the plan has no live version afterwards.

3

Archive a finished version

For DRAFT, FAILED VALIDATION, REJECTED, RETIRED or EXPIRED versions an "Archive" button is shown. Click it to set the state to ARCHIVED.

Expected Operational Outcome

The version is RETIRED or ARCHIVED. Its history and audit entries remain readable.

Troubleshooting & Failure Modes

Symptom: Error that the transition is invalid
Likely Cause: The version state does not allow it.
Resolution: Check the state badge; only the listed states can be retired or archived.

Was this guide helpful?

Help us refine our platform documentation