---
title: hydrogen link
description: Links your local development environment to a remote Hydrogen storefront.
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 link

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

### Examples

* ####

  ##### hydrogen link

  ```sh
  shopify hydrogen link [flags]
  ```

***