archivePlan( )

Archives a single pricing plan.

The archivePlan() function returns a promise that resolves to the newly-archived plan.

When a plan is archived, the plan:

  • Is no longer available for display or selection by visitors. This is because the plan's visibility property is automatically set to false.
  • Cannot be purchased.
  • Cannot be "un-archived" (meaning, the plan cannot be made active again).

Plan archiving does not impact existing purchases made for the plan. All purchases for the plan are still active and keep their payment options and terms.

Site owners can see archived plans in the Dashboard under Pricing Plans -> Archived Plans.

Only users with "Manage Pricing Plans" permissions can archive plans.

Note: An attempt to archive an already-archived plan throws an error.

Method Declaration
Copy
Method Parameters
idstringRequired

ID of the active plan to archive.

Returns
Return Type:Promise<Plan>
Was this helpful?
Yes
No