Skip to main content
Vincent Apps use versioning to ensure user trust and security. When users delegate to your App, they delegate to a specific version with an immutable set of Abilities and Policies that cannot be changed without their explicit consent.

​
Version Changes

  • Requires New Version
  • Can Change Anytime
​
abilities
array
Adding, updating, or removing Vincent Abilities from your App
​
policies
array
Modifying Vincent Policies for your App’s Abilities

​
Version Lifecycle

1

Create

Initialize the version off-chain with your chosen Abilities and Policies. Changes are still possible at this stage.
2

Publish

Register the version on-chain in the Vincent App Registry. Once published, the version becomes immutable and available for user delegation.
Published versions cannot be modified. To make changes, create and publish a new version.

​
How to Create a New Version

1

Navigate to the Developer Dashboard

Go to the Vincent Developer Dashboard
2

Access App Details

Select the App Details menu item from the sidebar menuApp Details menu in sidebar
3

Create New Version

Click Create App VersionCreate App Version button
4

Describe Your Changes

Provide a description of changes made to the application since your previous versionVersion changes description field
5

Configure Abilities and Policies

Similar to creating the first version, you’ll be redirected to add Abilities to your app version and configure policiesConfigure Abilities and Policies interface
6

Publish the App Version

On the left sidebar, click Apps, then App Versions, and select your new version to navigate to the App Version management page. Click the Publish App Version button to register the App Version as published in the Vincent Registry smart contractPublish App Version button
7

Set as Active Version

For users to see the version update, update the App’s active version through the Edit App pageSet active version interfaceAnd done! Now new users will permit your new app version, and existing users will be notified when they go to authenticate.

​
FAQ

Disabling an App Version immediately prevents users on that version from using your App. They’ll be prompted to upgrade to the latest enabled version. Your delegatees won’t be able to execute Abilities for users who only authorized the disabled version. Disabled versions can be re-enabled at any time.
Users are only notified when you set a new version as the active App Version. They won’t see notifications for versions you create or publish but don’t activate. Upgrade prompts appear when a new active version is available (optional if current version is enabled) or when their version is disabled (mandatory).
Versioning is fundamental to Vincent’s trust model. Every version is immutable once published, transparent in what it authorizes, and requires explicit opt-in from users for upgrades. This gives you control over your App’s evolution without compromising user permissions.

​
Next Steps

Deprecating App Versions

Learn how to disable old versions and manage user upgrades
⌘I