Save plan versions as drafts
You can now work on a plan's next version without publishing it. Save it as a draft, return to it later, then publish it as the next version or discard it. Each plan can have one draft at a time, and subscriptions can't subscribe or migrate to a draft version, so nothing bills from it until it's published.
- In the version settings step, choose Save as draft. The plan overview page then shows a banner to view, publish or discard the draft.
- Find drafts with the Drafts filter on the plans list.
- In the API, use
GET,PUTandDELETE /v1/plans/{plan_id}/draftandPOST /v1/plans/{plan_id}/draft/publish, withexternal_plan_idequivalents. The newhas_draftfield onPlanshows whether a draft exists.
Note that while a plan has a draft, POST /v1/plans/{plan_id}/versions and adding prices to the plan from Pricebook are blocked until the draft is published or discarded. Discarding a draft doesn't remove prices it added to your catalog, and archiving a plan in the dashboard discards its draft.
Learn more about plan versions in our docs.