Skip to content
Create account
or
Sign in
The Stripe Docs logo
/
Ask AI
Create account
Sign in
Get started
Payments
Finance automation
Platforms and marketplaces
Money management
Developer tools
Get started
Payments
Finance automation
Get started
Payments
Finance automation
Platforms and marketplaces
Money management
Overview
Versioning
Changelog
Upgrade your API version
Upgrade your SDK version
Developer tools
SDKs
API
Testing
Workbench
Event Destinations
Workflows
Stripe CLI
Stripe Shell
Developers Dashboard
Agent toolkit
Stripe health alertsBuild with LLMsStripe for Visual Studio CodeFile uploads
Security
Security
Extend Stripe
Stripe Apps
    Overview
    Get started
    Create an app
    How Stripe Apps work
    Sample apps
    Build an app
    Store secrets
    API authentication methods
    Authorization flows
    Server-side logic
    Listen to events
    Handle different modes
    Enable sandbox support
    App settings page
    Build a UI
    Onboarding
    Distribute your app
    Distribution options
    Upload your app
    Versions and releases
    Test your app
    Publish your app
    Promote your app
    Add deep links
    Create install links
    Assign roles in UI extensions
    Post-install actions
    App analytics
    Embedded components for Apps
    Embed third-party Stripe Apps
    Migrating to Stripe Apps
    Migrate or build an extension
    Migrate a plugin to Stripe Apps or Stripe Connect
    Reference
    App manifest
    CLI
    Extension SDK
    Permissions
    Viewports
    Design patterns
    Components
Stripe Connectors
Partners
Partner ecosystem
Partner certification
HomeDeveloper toolsStripe Apps

Manage your app's versions and releases

Learn about app versioning and releases to ship new versions of your app and manage changes over time.

Copy page

In Stripe Apps, a version is a framework to help you manage changes to your app over time. A release is a version of your app that you decide to publish—either to your own account or on the Stripe App Marketplace after passing app review.

Versions overview

The version property in the app manifest lets you specify the version of your app. Stripe doesn’t enforce a specific versioning schema for apps, but we recommend following an established pattern, like semantic versioning.

Stripe users who install your app don’t have to think about the version number. Stripe automatically upgrades them to the latest release of an app. The app functions in a similar manner to apps updating automatically on your phone. The only exception is cases where the permissions scope changes. If you change the permissions, users of your app are prompted to re-authorize your app and its new permissions.

How to upload a new app version

  1. Change the version property in the app manifest.
  2. Upload the new app version to Stripe. Follow the same upload process that you used when creating an app.

Changing between app versions in test mode

You can change between different app versions in test mode and sandbox environments before creating a release.

  1. In the Stripe Dashboard, go to Apps.
  2. Select the app you want to create a new version for, and view App Details.
  3. In the version history table, click the overflow menu () of the new version.
  4. Select Install in test mode and complete the installation.

Releases overview

To distribute your app in live mode for users, create a new release. You can publish it to your own account or to the App Marketplace. To be listed in the App Marketplace, releases must go through App Review.

How to create a new release

  1. In the Stripe Dashboard, go to Apps.
  2. Select the app you want to create a new version for, and view App Details.
  3. Click Create new release.
  4. Follow the steps to create a new release.

When your release passes app review, all users are automatically upgraded to the latest released version.

How to remove an app listing or change a release

App releases can only be fixed forward. To remove an app listing or change an app release that had accidental changes, bump the app version and make a new release of the app.

Since we don’t enforce a versioning structure, an incremental release is any release created after the current live version. For example, if version 2.0.0 was uploaded before version 1.0.0, version 2.0.0 won’t be available to create a release.

To remove an app or an app release from Stripe, contact Stripe Support.

See also

  • Upload your app
  • Publish your app
  • App review requirements
Was this page helpful?
YesNo
Need help? Contact Support.
Join our early access program.
Check out our changelog.
Questions? Contact Sales.
LLM? Read llms.txt.
Powered by Markdoc