---
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. 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. 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]
  ```