Here’s how to update your app’s current version in the App Market to a newer version:
- Log in to your account in the and select the relevant app.
- Make the relevant changes to the app.
- Click Versions in the side menu (under Publish Your App).
4. Click Create New Version.
Whenever you make a change to your app it creates a new version. It will either create a Minor Version or Major Version, depending on the type of change. Here's how it works:
Whenever you have an approved version of your app it moves to a new draft by default. Versioned changes get saved to the draft and only start taking effect on users once it's submitted for approval, approved, and published.
In the Versions tab you'll see Version and Actual Version. Version counts how many versions you have, while Actual Version is what our system uses to determine which version users get.
The format of Actual Version is as follows:
- The very first version will have Actual Version set as DRAFT.
- Once approved it turns into 1.0.0. The "1" represents a Major Version, the first "0" a Minor Version and the last "0" isn't currently use.
- Users will always get all Minor updates for the Major Version they've installed. E.g. a user is on version 1.0.0 and you publish a Minor update, the app is now 1.1.0 and the user is updated to that version. If you then made a Major change, the app would update to 2.0.0, but the user would remain on 1.1.0 until they uninstall and reinstall the app (or update the app when that feature releases in the future).
Most changes are Minor changes, and these usually don't really impact production. This could be changes to things like marketing, company info, etc.
This could be adding or removing a component, changing an "Embedded Script" script (for apps with this feature), adding or removing permissions, etc.
- Webhooks: if you change your webhook endpoint, or add/remove a webhook it should immediately take effect. The only time you need to resubmit your app is if a webhook requires a new permission.
- App OAuth endpoints and redirect URLs: you can change these whenever you like, but be careful as they'll impact production.
- Team members
Important: Versioning means that if you update your iframe endpoint, users on older Major versions won't receive that update. So it's important to keep old endpoints going until you migrate users to your newer version.