Updating Edition apps
Learn how to publish a new version of an Edition app.
This guide explains how to release a new version of an Edition app by defining new required apps for child accounts or by changing the Edition's initial settings.
Before you begin
Before proceeding, ensure you are a Sponsor Account and have already configured an Edition app.
Instructions
- Open your Edition app's folder and access the
apps.jsonfile using your preferred code editor. - Make the desired changes to the apps and settings in the file.
Be aware that if you add an app to the Edition that is already installed on a child account, the app's installation type changes to
edition. You can no longer remove it from the accounts or change its major version, as the Edition now enforces it. Similarly, if you remove an app fromapps.json, VTEX will automatically uninstall it from all child accounts using this Edition. If you still need the removed app in some child accounts, you must reinstall it manually in each of those accounts. - Save and commit your changes.
- Publish and deploy the new Edition version.
Understanding the update process
After you publish the new version, VTEX automatically updates the Edition in all associated accounts. This process runs asynchronously, periodically, and individually for each child account.
Note: VTEX only applies automatic updates for minor and patch version changes. If you release a new major version (a breaking change), you must update the Edition manually in each child account.