Help Center/Plan Configurator & Compensation Models/How to activate or schedule an approved plan version
Plan Configurator & Compensation Models•Last updated: 2026-10-20•4 min read

How to activate or schedule an approved plan version

Release an APPROVED version now with "Activate now", or choose a future "Effective from" time with "Schedule". A saved plan never goes live on its own.

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

Ask AI Copilot

Step-by-Step Procedure

1

Open the APPROVED version

The release controls appear only when the version state is APPROVED and you hold plan.release.

2

Release immediately

Click "Activate now". The server re-checks the content hash, the approvals for that exact hash and that no blocking finding exists. The message "Released: the plan is live." confirms it.

3

Or schedule a release

Fill the "Effective from" date and time, then click "Schedule". The time must be in the future. The version becomes SCHEDULED and the panel shows "Scheduled for ...".

4

Run due releases

For a SCHEDULED version a "Run due releases" button triggers a sweep: due versions are activated and expired ones are marked. Scheduled releases are activated by this sweep; the page does not show a timer.

Expected Operational Outcome

The version is ACTIVE (or SCHEDULED until its time). Engines read the plan rules from this live version.

Troubleshooting & Failure Modes

Symptom: Error ACTIVATION_BLOCKED
Likely Cause: A blocking finding appeared when re-validated.
Resolution: Fix the definition in a new version.
Symptom: Error NOT_APPROVED or TAMPERED
Likely Cause: Approvals do not match the current content.
Resolution: Re-submit and re-approve.
Symptom: Error that the effective date has not been reached
Likely Cause: The definition has an effective-from date in the future.
Resolution: Use "Schedule" instead of "Activate now".

Was this guide helpful?

Help us refine our platform documentation