Manage Blocks App Versions

Release a version of your app whenever you want to distribute a new feature to your users or sites. To release a version, click Build in Blocks. Before releasing a version, make sure to test your app.

Version types

Choose one of two versions:

• Major version. Release a major version when you've made changes that break compatibility. Your first release must be a major one. Changes come into effect after users manually update the app and publish their site.
• Minor version. Release a minor version when you've made small changes that don't break compatibility. A minor version will automatically change on any site the app is installed on. It takes 5-15 minutes to update in the live site. 

Changes that require a major version

Some changes are substantial changes that cannot allow a minor version. 

If you added the following items in Blocks, your next build must be major or test:

• Wix app dependencies
• Add Code files for the first time, or
• Add a CMS collection for the first time

If you made the following changes in your app dashboard, your next version will be a major version:  

• Added or removed Permissions
• Added an Embedded Script extension
• Changed Dynamic Key Parameters of an Embedded Script

Version numbering

Wix Blocks automatically updates the version number. For example, if your previous release was 1.0, and you release a minor version, Blocks assigns it the version number 1.1. If your previous release was 2.2, and you release a major version, Blocks assigns it the version number 3.0. 

Apps published in the App Market

If you've published your app in the App Market and want to update it to the latest version you've released, there’s no need to resubmit it for review. Minor changes will be automatically received by users, while major updates will be available if they choose to update.

However, certain changes are not included in your Blocks version release and are managed directly through your app dashboard:

• Market listing: Updates to your app’s public information, including media, contact details, etc.
• Pricing: Changes to your pricing plans. These also require you to resubmit your app for review.

Apps that weren't created in Blocks

If you added a Blocks extension to an already existing app that wasn't created in Blocks, make sure to release a minor version in Blocks. A major version will require a manual update of the application in all the sites it's installed on.