During your app's life cycle, from bug fixes to new features to promotions, there are different reasons you may need to release a new version of your app. Wix categorizes releases as major or minor and handles versioning accordingly.
Versioning your app follows the same process the same whether your app is private, unlisted or listed in the App Market.
Important: Changes to the versioning flow are currently being rolled out in stages and aren't available to all users yet.
There are 2 types of app version releases:
Major updates are not pushed automatically and require user action. Users receive notifications about available version releases in the Manage Apps page and must click the Update button to accept the new version release.
You can also include a call to action within your app to prompt them to update to the latest version, redirecting them to https://wix.com/app-installer?appId={appId}.
If you’re using custom authentication (legacy), you also need to take the site owner through the OAuth flow. You will receive an authorization code with which you must request a new refresh token. Store the refresh token in your database for later use together with the site owner's instance ID.
Major version numbering: 2.10.0. In this example, '2' denotes the major version.
You can always decide that a change to your app should be considered a major version and require user action for installation, but this isn't recommended, as users won't always update.
Most version releases are considered minor. Wix users that have installed the latest major version, automatically receive minor releases on top of that version. If they are not on the latest major version, they will be offered to update with the Update button on the Manage Apps page. This will provide the release via the major version release flow, including any new minor releases.
Minor version numbering: 2.10.0. In this example, '10' denotes the minor version.
Below is a list of changes you might implement in your app, along with the corresponding version types they require:
| Minor version | Major version (use sparingly) |
|---|---|
| - Changes to translations - Changes to app company info - Adding, changing or removing extensions - Changes to pre-installed automations - Removing permissions | - Adding permissions - Adding an Embedded Script extension - Changes to Dynamic Parameters of an Embedded Script |
You can always choose to release a major version even if the changes to your app can be considered a minor version - however this generally isn't recommended, as it requires users to actively update your app, and they don't always do so.
The following changes are pushed to users immediately and don't require a version release:
The following changes require submission to the Wix App Market for review, but don't require a version release:
If you've made a change to a self-hosted app that requires a version release, you'll see that you have a version that isn't updated in the Distribute page.
If you've made a change to a Blocks app, you'll see that the Release button is enabled in the Blocks Editor.