Plans V1: Migration Guide

This guide helps you migrate from Plans V1 to the Plans V3 API. Plans V1 will be removed on December 31, 2025.

Key changes

Plans V3 is a new and improved version of V1. The API has been standardized according to the latest Wix API design rules.

The following methods don't have a 1:1 replacement and need to be replaced with alternative methods:

  • List Public Plans: To retrieve public plans, call Query Plans or Search Plans from the Plans V3 API. In the filter object, set the visibility field to PUBLIC and the archived field to false.
  • Query Public Plans: To retrieve public plans, call Query Plans or Search Plans from the Plans V3 API. In the filter object, set the visibility field to PUBLIC and the archived field to false.
  • Set Plan Visibility: To update plan visibility, call Update Plan from the Pricing Plans V3 API and modify the visibility field value.
  • Make Plan Primary: To set a plan as primary, first call Query Plans from the Plans V3 API and filter by primary: true. For the filtered plans, call Bulk Update Plans to set the primary field to false. Then set the primary field to true for the new plan.
  • Clear Primary: To remove a plan's primary status, call Query Plans from the Plans V3 API and filter by primary: true. For the filtered plans, call Bulk Update Plans to set the primary field to false.
  • Archive Plan: To archive a plan, call Update Plan from the Plans V3 API and set the archived field to true.

Support

  • Plans V3 API
  • Contact Wix Developer Support for additional assistance.
Did this help?