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

How to simulate a plan event in the composer

The "Simulate" tab runs the real calculation engine in your browser against sample facts. It is pure and deterministic; nothing is posted, stored or sent to the server.

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

Ask AI Copilot

Step-by-Step Procedure

1

Open "Simulate" and choose the "Event"

The list shows the events of your Trigger nodes. Sample facts are generated for the chosen event.

2

Edit the facts

Change "Event inputs & facts (JSON)" to the scenario you want. "Reset sample facts" restores the sample. Optionally set "Cap usage already consumed (JSON)", for example the amount already used by a recipient.

3

Click "Run simulation"

A JSON error is shown in red if the facts are not valid JSON.

4

Read the result

The result status is one of CALCULATED, PENDING_APPROVAL, HELD, REJECTED, FAILED or NOT_APPLICABLE. A table lists each reward with recipient, amount, before rounding, residual, status and caps, followed by "Cap usage to apply" and notifications.

5

Open the trace

Expand "Calculation trace" to see every node step with its inputs and results.

Expected Operational Outcome

You can see exactly what the rules would calculate for those facts. No member balance, ledger or live plan changed.

Troubleshooting & Failure Modes

Symptom: The result says REJECTED or HELD
Likely Cause: A guard or approval node stopped the event.
Resolution: Read the "... at <node>" line and the trace.

Was this guide helpful?

Help us refine our platform documentation