When you edit a plan in Schematic — whether changing its entitlements, pricing, or other details — those changes are saved as a new draft plan version. This lets you review and control exactly when changes take effect and how existing subscribers are handled.
This guide walks through rolling out a new plan version, using the plans set up in Setting up your First Plans as a starting point. We’ll add a new feature to both plans and publish the updated versions.
Any edit to a plan creates a new draft version. For this example, we’ll add a new “Advanced Analytics” feature to both the Starter and Pro plans.
First, create the feature in the Features tab, then go to each plan and click Add Feature to entitle it.
Once you’ve made your changes, you’ll see a banner indicating that the plan has unpublished changes. Click the Publish button in the top right corner to begin the publishing flow.
The first step lets you review a summary of what changed in this version — including which entitlements were added, removed, or modified.
The next step determines what happens to companies currently on this plan. You have two options:
If you choose to migrate companies, the next screen lets you select which companies to migrate. Any companies not selected will remain on the prior version.
After publishing, you can track migration progress on the Migrations tab of the plan page.
Repeat this publish flow for each plan you’ve updated.
For more details on plan versioning, see the Plans documentation.