Skip to main content

app deploy

Builds the app, 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. You need to deploy your web app to your own hosting solution.

The following flags are available for the app deploy command:

Anchor to --allow-deletes
--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.

Anchor to --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.

Anchor to --client-id <value>
--client-id <value>
string
env: SHOPIFY_FLAG_CLIENT_ID

The Client ID of your app.

Anchor to --message <value>
--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.

Anchor to --no-build
--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.

Anchor to --no-color
--no-color
env: SHOPIFY_FLAG_NO_COLOR

Disable color output.

Anchor to --no-release
--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.

Anchor to --path <value>
--path <value>
string
env: SHOPIFY_FLAG_PATH

The path to your app directory.

Anchor to --reset
--reset
env: SHOPIFY_FLAG_RESET

Reset all your settings.

Anchor to --source-control-url <value>
--source-control-url <value>
string
env: SHOPIFY_FLAG_SOURCE_CONTROL_URL

URL associated with the new app version.

Anchor to --verbose
--verbose
env: SHOPIFY_FLAG_VERBOSE

Increase the verbosity of the output.

Anchor to --version <value>
--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.

Anchor to -c, --config <value>
-c, --config <value>
string
env: SHOPIFY_FLAG_APP_CONFIG

The name of the app configuration.

Anchor to -f, --force
-f, --force
env: SHOPIFY_FLAG_FORCE

Deploy without asking for confirmation. Equivalent to --allow-updates --allow-deletes. For CI/CD environments, the recommended flag is --allow-updates.

Examples

app deploy

shopify app deploy [flags]
Was this page helpful?