About app versions

After you set up your app configuration or create one or more app extensions, you can deploy these components together and release a new app version to users. An app version is a snapshot of your app configuration and all extensions.

Anchor to Deployment workflowDeployment workflow

Your app configuration and all extensions are versioned together as a single app version.

When you run the deploy command using Shopify CLI, an app version is created and released. You can revert to a previous app version at any time. You can also create an app version from the Dev Dashboard.

Releasing an app version replaces the current active version that's served to stores that have your app installed. It might take several minutes for app users to be upgraded to the new version.

Tip

If you want to deploy app configuration and extensions to Shopify regularly, then you can integrate Shopify CLI into your CI/CD pipeline to programmatically deploy your app components using the deploy command.

Anchor to How app versions are createdHow app versions are created

The contents of your app version are different depending where you create it.

For details about creating and managing app versions, refer to Deploy and release app versions.

Tool	App version contents
Shopify CLI	An app version created using Shopify CLI contains the following: The app configuration from the local configuration file. The local version of the app's extensions. If you have an extension in your deployed app, but the extension code doesn't exist locally, then the extension isn't included in the version.
Dev Dashboard: App version create page	An app version created from the version create page in the Dev Dashboard contains the configuration on that page, as well as any extensions that are present on the current active version of the app.

Tool

App version contents

Shopify CLI

An app version created using Shopify CLI contains the following:

The app configuration from the local configuration file.
The local version of the app's extensions. If you have an extension in your deployed app, but the extension code doesn't exist locally, then the extension isn't included in the version.

Dev Dashboard: App version create page

An app version created from the version create page in the Dev Dashboard contains the configuration on that page, as well as any extensions that are present on the current active version of the app.

Was this page helpful?