---
title: app deploy
description: 'Builds the app, then deploys your app configuration and extensions.'
api_name: shopify-cli
source_url:
  html: 'https://shopify.dev/docs/api/shopify-cli/app/app-deploy'
  md: 'https://shopify.dev/docs/api/shopify-cli/app/app-deploy.md'
---

# app deploy

[Builds the app](https://shopify.dev/docs/api/shopify-cli/app/app-build), then deploys your app configuration and extensions.

This command creates an app version, which is a snapshot of your app configuration and all extensions. This version is then released to users.

This command doesn't deploy your [web app](https://shopify.dev/docs/apps/tools/cli/structure#web-components). You need to [deploy your web app](https://shopify.dev/docs/apps/deployment/web) to your own hosting solution.

#### Flags

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

* **--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.

* **--allow-updates**

  **''**

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

  Allows adding and updating extensions and configuration without requiring user confirmation. Recommended option for CI/CD environments.

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

  **string**

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

  The Client ID of your app.

* **--message \<value>**

  **string**

  **env: SHOPIFY\_FLAG\_MESSAGE**

  Optional message that will be associated with this version. This is for internal use only and won't be available externally.

* **--no-build**

  **''**

  **env: SHOPIFY\_FLAG\_NO\_BUILD**

  Use with caution: Skips building any elements of the app that require building. You should ensure your app has been prepared in advance, such as by running `shopify app build` or by caching build artifacts.

* **--no-color**

  **''**

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

  Disable color output.

* **--no-release**

  **''**

  **env: SHOPIFY\_FLAG\_NO\_RELEASE**

  Creates a version but doesn't release it - it's not made available to merchants. With this flag, a user confirmation is not required.

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

  **string**

  **env: SHOPIFY\_FLAG\_PATH**

  The path to your app directory.

* **--reset**

  **''**

  **env: SHOPIFY\_FLAG\_RESET**

  Reset all your settings.

* **--source-control-url \<value>**

  **string**

  **env: SHOPIFY\_FLAG\_SOURCE\_CONTROL\_URL**

  URL associated with the new app version.

* **--verbose**

  **''**

  **env: SHOPIFY\_FLAG\_VERBOSE**

  Increase the verbosity of the output.

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

  **string**

  **env: SHOPIFY\_FLAG\_VERSION**

  Optional version tag that will be associated with this app version. If not provided, an auto-generated identifier will be generated for this app version.

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

  **string**

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

  The name of the app configuration.

* **-f, --force**

  **''**

  **env: SHOPIFY\_FLAG\_FORCE**

  \[Deprecated] Deploy without asking for confirmation. Equivalent to --allow-updates --allow-deletes. Use --allow-updates for CI/CD environments instead.

Examples

### Examples

* ####

  ##### app deploy

  ```sh
  shopify app deploy [flags]
  ```

***