---
title: app deploy
description: "[Builds the app](/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, including the app extensions that you manage in the Partner Dashboard. This version is then released to users.


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

  \  "
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 deploycommand

[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, including the app extensions that you manage in the Partner Dashboard. 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:

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

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

  Deploy without asking for confirmation.

### Examples

* #### app deploy

  ##### app deploy

  ```bash
  shopify app deploy [flags]
  ```