Shopify CLI Hydrogen commands
Hydrogen 2026-10 supports a subset of the Shopify CLI Hydrogen commands. In a Hydrogen 2026-10 project, use your framework's commands to build, run, and generate code. The @shopify/hydrogen package includes a hydrogen command for setup, gql check, skills check, skills sync, certs install, and certs uninstall. Run a @shopify/hydrogen command with npx @shopify/hydrogen <command>. With @shopify/hydrogen installed, Shopify CLI with @shopify/cli-hydrogen 13.0.1 or later stops an unsupported command and shows an error.
To start a Hydrogen 2026-10 project, add Hydrogen to a new or existing project. To upgrade a project, refer to Migrate to the latest version of Hydrogen.
| Command | Hydrogen 2026-10 | Hydrogen 2026-04 and earlier |
|---|---|---|
hydrogen customer-account-push | Yes | Yes |
hydrogen deploy | Yes | Yes |
hydrogen env list | Yes | Yes |
hydrogen env pull | Yes | Yes |
hydrogen env push | Yes | Yes |
hydrogen link | Yes | Yes |
hydrogen list | Yes | Yes |
hydrogen login | Yes | Yes |
hydrogen logout | Yes | Yes |
hydrogen unlink | Yes | Yes |
hydrogen init | No. Creates a Hydrogen 2026-04 project. | Yes |
hydrogen build | No | Yes |
hydrogen check | No | Yes |
hydrogen codegen | No | Yes |
hydrogen debug cpu | No | Yes |
hydrogen dev | No | Yes |
hydrogen generate route | No | Yes |
hydrogen generate routes | No | Yes |
hydrogen preview | No | Yes |
hydrogen setup | No | Yes |
hydrogen setup css | No | Yes |
hydrogen setup markets | No | Yes |
hydrogen setup vite | No | Yes |
hydrogen shortcut | No | Yes |
hydrogen upgrade | No | Yes |
hydrogen build
Builds a Hydrogen storefront for production.
hydrogen check
Checks whether your Hydrogen app includes a set of standard Shopify routes.
hydrogen codegen
Automatically generates GraphQL types for your project’s Storefront API queries.
hydrogen customer-account-push
Push project configuration to admin
hydrogen debug cpu
Builds the app and runs the resulting code to profile the server startup time, watching for changes.
hydrogen deploy
Builds and deploys your Hydrogen storefront to Oxygen.
hydrogen dev
Runs a Hydrogen storefront in a local runtime that emulates an Oxygen worker for development.
hydrogen env list
Lists all environments available on the linked Hydrogen storefront.
hydrogen env pull
Pulls environment variables from the linked Hydrogen storefront into an .env file, leaving secret values empty.
hydrogen env push
Push environment variables from the local .env file to your linked Hydrogen storefront.
hydrogen generate route
Generates the selected route group from the starter template.
hydrogen generate routes
Generates all supported standard shopify routes.
hydrogen init
Creates a new Hydrogen storefront.
hydrogen link
Links your local development environment to a remote Hydrogen storefront.
hydrogen list
Lists all remote Hydrogen storefronts available to link to your local development environment.
hydrogen login
Logs in to the specified shop and saves the shop domain to the project.
hydrogen logout
Logs out of Shopify and clears .shopify/project.json, including the storefront link.
hydrogen preview
Runs a server in your local development environment that serves your Hydrogen app's production build.
hydrogen setup css
Adds support for certain CSS strategies to your project.
hydrogen setup markets
Adds support for multiple markets to your project by using the URL structure.
hydrogen setup vite
EXPERIMENTAL: Upgrades the project to use Vite.
hydrogen setup
Scaffold routes and core functionality.
hydrogen shortcut
Creates a global h2 shortcut for Shopify CLI using shell aliases.
hydrogen unlink
Unlinks your local development environment from a remote Hydrogen storefront.
hydrogen upgrade
Upgrade Hydrogen project dependencies, preview features, fixes and breaking changes.