---
title: hydrogen link
description: |-
  Links your local development environment to a remote Hydrogen storefront. You can link an unlimited number of development environments to a single Hydrogen storefront.

    Linking to a Hydrogen storefront enables you to run [dev](/docs/api/shopify-cli/hydrogen/hydrogen-dev) and automatically inject your linked Hydrogen storefront's environment variables directly into the server runtime.

    After you run the `link` command, you can access the [env list](/docs/api/shopify-cli/hydrogen/hydrogen-env-list), [env pull](/docs/api/shopify-cli/hydrogen/hydrogen-env-pull), and [unlink](/docs/api/shopify-cli/hydrogen/hydrogen-unlink) commands.
api_name: shopify-cli
source_url:
  html: https://shopify.dev/docs/api/shopify-cli/hydrogen/hydrogen-link
  md: https://shopify.dev/docs/api/shopify-cli/hydrogen/hydrogen-link.md
---

# hydrogen linkcommand

Links your local development environment to a remote Hydrogen storefront. You can link an unlimited number of development environments to a single Hydrogen storefront.

Linking to a Hydrogen storefront enables you to run [dev](https://shopify.dev/docs/api/shopify-cli/hydrogen/hydrogen-dev) and automatically inject your linked Hydrogen storefront's environment variables directly into the server runtime.

After you run the `link` command, you can access the [env list](https://shopify.dev/docs/api/shopify-cli/hydrogen/hydrogen-env-list), [env pull](https://shopify.dev/docs/api/shopify-cli/hydrogen/hydrogen-env-pull), and [unlink](https://shopify.dev/docs/api/shopify-cli/hydrogen/hydrogen-unlink) commands.

## Flags

The following flags are available for the `hydrogen link` command:

* \--path \<value>

  string

  env: SHOPIFY\_HYDROGEN\_FLAG\_PATH

  The path to the directory of the Hydrogen storefront. Defaults to the current directory where the command is run.

* \--storefront \<value>

  string

  env: SHOPIFY\_HYDROGEN\_STOREFRONT

  The name of a Hydrogen Storefront (e.g. "Jane's Apparel")

* -f, --force

  env: SHOPIFY\_HYDROGEN\_FLAG\_FORCE

  Overwrites the destination directory and files if they already exist.

### Examples

* #### hydrogen link

  ##### hydrogen link

  ```bash
  shopify hydrogen link [flags]
  ```