---
title: About app versions
description: Learn about the deployment model for app configuration and extensions.
source_url:
  html: 'https://shopify.dev/docs/apps/launch/deployment/app-versions'
  md: 'https://shopify.dev/docs/apps/launch/deployment/app-versions.md'
---

ExpandOn this page

* [Deployment workflow](https://shopify.dev/docs/apps/launch/deployment/app-versions.md#deployment-workflow)
* [How app versions are created](https://shopify.dev/docs/apps/launch/deployment/app-versions.md#how-app-versions-are-created)

# About app versions

After you set up your [app configuration](https://shopify.dev/docs/apps/build/cli-for-apps/app-configuration) or create one or more [app extensions](https://shopify.dev/docs/apps/build/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.

***

## Deployment workflow

Your app configuration and all extensions are versioned together as a single [app version](https://shopify.dev/docs/apps/launch/deployment/app-versions).

When you run the [`deploy` command](https://shopify.dev/docs/api/shopify-cli/app/app-deploy) using [Shopify CLI](https://shopify.dev/docs/api/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](https://shopify.dev/docs/apps/launch/deployment/deploy-in-ci-cd-pipeline) to programmatically deploy your app components using the [`deploy` command](https://shopify.dev/docs/api/shopify-cli/app/app-deploy).

***

## How 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](https://shopify.dev/docs/apps/launch/deployment/deploy-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](https://shopify.dev/docs/apps/build/cli-for-apps/app-configuration).
- 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. |

***

* [Deployment workflow](https://shopify.dev/docs/apps/launch/deployment/app-versions.md#deployment-workflow)
* [How app versions are created](https://shopify.dev/docs/apps/launch/deployment/app-versions.md#how-app-versions-are-created)