Deploy and release app versions

When you're ready to release your changes to users, you can create and release an app version. An app version is a snapshot of your app configuration and all extensions.

The contents of your app version depend on where you create it. You can create an app version using Shopify CLI or the Partner Dashboard. However, to create an app version that updates your CLI-managed extensions, you need to create the app version using Shopify CLI.

Before you create a new app version, you might want to preview one or more of your extensions. To learn how to preview and test your app extension, refer to the documentation for your extension type.

Some app versions need to be reviewed by Shopify before they can be released. You can submit an app version for review through the Partner Dashboard.

You can also set up your CI/CD pipeline to deploy your app configuration and extensions programmatically.

Follow these steps to create an app version using Shopify CLI:

1. Navigate to your app directory.

2. Run the following command.

   Optionally, you can provide a name or message for the version using the --version and --message flags.

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.

After you release your new app version, you can view the version details in the Partner Dashboard, or by running the versions list command in Shopify CLI.

Follow these steps to update app configuration and release an app version using the Partner Dashboard:

1. From the Partner Dashboard, go to Apps.

2. Select your app from the list.

3. Click Configuration.

4. In the Configuration page, make your changes.

5. Click Save and release.

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.

After you release your new app version, you can view the version details in the Partner Dashboard, or by running the versions list command in Shopify CLI.

Follow these steps to release an app version that includes changes of dashboard-managed extensions:

1. From the Partner Dashboard, go to Apps.

2. Select your app from the list.

3. Click Versions.

4. From the Versions page, click Create version.

5. Optional: enter a name and message for the version.

6. Click Release. If you don't want to release right away, then you can click Create version.

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.

After you release your new app version, you can view the version details in the Partner Dashboard, or by running the versions list command in Shopify CLI.

You can deploy your app configuration and any app extensions that you generated using Shopify CLI in a CI/CD pipeline.

Your app configuration and all extensions, including extensions created in the Partner Dashboard, are versioned together as a single app version.

If you created an app version without releasing it, or you want to roll back to a previous app version, then you can release it using Shopify CLI or the Partner Dashboard.

1. Navigate to your app directory.

2. Run the following command. Replace VERSION with the name of the version that you want to release.

1. From the Partner Dashboard, go to Apps and then select your app from the list.
2. Click Versions.
3. From the Versions page, select the app version that you want to release.
4. On the app version page, click Release.

Depending on the extension types included in your app version, your version might need to be reviewed by Shopify. To understand which extension types require a review, refer to the list of extension types.

1. From the Partner Dashboard, go to Apps.
2. Select your app from the list.
3. Click Versions.
4. Select the version that you want to release.

5. Click Submit for review.

6. When Shopify has reviewed and approved the app version, click Release to release the new app version to users.

Learn how to remove an app extension from your app.