Why versioning exists
Once a contract is signed, the price, included hours, rollover rules, and overage rate are part of an agreement with a customer. If editing the plan retroactively changed every active contract, you'd silently re-price live retainers — or worse, change historical billing. Versioning prevents that.
Rule of thumb: Editing a plan never affects a contract that's already using it. The customer keeps what they signed up for.
How it works
Open Contracts → Retainers to review or edit a plan. Creating a plan saves Version 1; saving an existing plan creates its next version.
- Saving an edit creates a new version. The previous version is archived, and the new one becomes active. Only one version per plan is active at a time.
- Contracts reference a specific version. When you create a contract on Growth v3, the contract is tied to v3 — not "Growth, current".
- Three layers of insulation protect a contract from drift:
- The contract row denormalizes the version's terms into its own fields.
- Each period row stores a frozen
termsSnapshotof what was in effect when the period was created — closed periods can't drift. - Any scheduled plan change stores its own terms snapshot too, so editing the plan after scheduling doesn't change what gets applied.
What "new version" actually changes
| Who | What they see after the edit |
|---|---|
| New contracts | Pick up the new version automatically. |
| Existing contracts on the old version | No change. They stay on the version they signed up for. |
| Existing contracts on the new version (rare — version-locked schedules) | No change for the current period; the next-cycle terms reflect the snapshot at scheduling time. |
How to migrate a contract to a newer version
Editing the plan never auto-migrates customers. To move a contract to the terms from a plan's current version, schedule a change from Billing & retainer → Retainer. The plan change captures the target terms in its own snapshot.
- Open the contract's Billing & retainer → Retainer view.
- Click Schedule change and pick the target plan. The current plan version is used.
- Set an effective date that is the first day of one of this contract's retainer periods. The valid day follows the contract's start-date anniversary and may not be the first of the calendar month.
- Click Preview impact to see how the next period will look.
- Click Schedule change for a future change or Apply retroactively for a correction to an earlier open period.
Reading version history
Every plan keeps its version history, while the Retainer plans catalog presents the current version for new agreements and plan changes. Existing contracts retain their saved snapshots. If a customer must keep older or custom terms, preserve them on the existing contract rather than assuming an archived version is available in the plan-change picker.