---
title: app release
description: Releases an existing app version.
source_url:
  html: 'https://shopify.dev/docs/api/shopify-cli/app/app-release'
  md: 'https://shopify.dev/docs/api/shopify-cli/app/app-release.md'
api_name: shopify-cli
---

# app release

Releases an existing app version. Pass the name of the version that you want to release using the `--version` flag.

#### Flags

The following flags are available for the `app release` command:

* **--version \<value>**

  **string**

  **required**

  **env: SHOPIFY\_FLAG\_VERSION**

  The name of the app version to release.

* **--allow-deletes**

  **env: SHOPIFY\_FLAG\_ALLOW\_DELETES**

  Allows removing extensions and configuration without requiring user confirmation. For CI/CD environments, the recommended flag is --allow-updates. Required in non-interactive environments unless --allow-updates is provided.

* **--allow-updates**

  **env: SHOPIFY\_FLAG\_ALLOW\_UPDATES**

  Allows adding and updating extensions and configuration without requiring user confirmation. Recommended option for CI/CD environments. Required in non-interactive environments unless --allow-deletes is provided.

* **--auth-alias \<value>**

  **string**

  **env: SHOPIFY\_FLAG\_AUTH\_ALIAS**

  Alias of the Shopify account to use for authentication.

* **--client-id \<value>**

  **string**

  **env: SHOPIFY\_FLAG\_CLIENT\_ID**

  The Client ID of your app.

* **--no-color**

  **env: SHOPIFY\_FLAG\_NO\_COLOR**

  Disable color output.

* **--path \<value>**

  **string**

  **env: SHOPIFY\_FLAG\_PATH**

  The path to your app directory.

* **--reset**

  **env: SHOPIFY\_FLAG\_RESET**

  Reset all your settings.

* **--verbose**

  **env: SHOPIFY\_FLAG\_VERBOSE**

  Increase the verbosity of the output. May include sensitive data.

* **-c, --config \<value>**

  **string**

  **env: SHOPIFY\_FLAG\_APP\_CONFIG**

  The name of the app configuration.

Examples

### Examples

* ####

  ##### app release

  ```sh
  shopify app release --version <version>
  ```

***