Help Center/Plan Configurator & Compensation Models/How to create a plan draft in the Plan Studio
Plan Configurator & Compensation Models•Last updated: 2026-10-20•4 min read

How to create a plan draft in the Plan Studio

Create a brand-new plan as a draft by pasting or inserting a plan definition (JSON) in the "New plan" box. A draft is never live: saving does not activate anything.

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

Ask AI Copilot

Step-by-Step Procedure

1

Open the Plan Studio

Go to Admin Console, then Plan Studio. The page is titled "Plan Studio · Governance Center". The "Your access" card on the left lists your DID and roles; check that you are not shown as "Roles: none".

2

Find the "New plan" box

In the left column, below the plan library, the "New plan" card contains a "Plan definition (JSON)" text area with the buttons "Insert template" and "Create draft".

3

Insert the template or paste your definition

Click "Insert template" to load an example definition (identity, commercialTerms, triggers, outcomes, riskLimits, disclosure, dependencies), then change the planId, name, planType and the numbers. The definition must contain an identity section with a planId.

💡 Pro Tip: The template contains example numbers. Replace every one with a figure that has been approved by the business; nothing is validated against policy until you submit for review.
4

Check the plan type

Under the box the page lists "Creatable types" and "Retired" types. Binary (weaker-leg) plans are retired and cannot be created; the server answers with a RETIRED_TYPE error.

5

Click "Create draft"

If the JSON is malformed you see a "JSON:" error and nothing is sent. Otherwise the Studio creates the plan with version 1 in state DRAFT, shows "Draft created." and selects the new plan.

6

Continue in the composer or edit the definition

Use "Open in Composer" for the visual editor, or "Edit definition" to edit the JSON directly. The draft stays a draft until it is submitted, approved and released.

Expected Operational Outcome

A new plan appears in the plan library with a version v1 badge in state DRAFT. It is not live and no member is affected.

Troubleshooting & Failure Modes

Symptom: The "New plan" box is missing
Likely Cause: Your account lacks plan.create.
Resolution: Ask a Super Administrator to grant you the PLAN_DESIGNER role (see the guide on granting plan roles).
Symptom: Error "Plan ... already exists"
Likely Cause: The planId is already used by another plan.
Resolution: Choose a unique planId, or open the existing plan and use "New version".
Symptom: Error about a retired plan type
Likely Cause: You chose a retired type such as Binary.
Resolution: Pick one of the listed "Creatable types".

Was this guide helpful?

Help us refine our platform documentation