Environments

The production and preview environments are required for all storefronts, and can't be deleted. In addition to these required environments, you can optionally create additional custom environments to develop new features, test out ideas, and more.

1. In your Hydrogen storefront, click Storefront settings.
2. Click Environments and variables.
3. Click Add environment.
4. Select an existing repository branch to link to the environment, or create a new branch.
5. Type a name for the branch. The name determines the environment URL.
6. Select whether to make the environment public or private.
7. Optional: Under Copy environment variables, select an existing environment to copy variables from.
8. Click Save.

1. In your Hydrogen storefront, click Storefront settings.
2. Click Environments and variables.
3. Click the environment to edit.
4. Make your changes.
5. Click Save.

1. In your Hydrogen storefront, click Storefront settings.
2. Click Environments and variables.
3. Click the environment to delete.
4. Click Delete environment.

Each environment can have its own set of environment variables, which are key-value pairs. Variable keys can be called in your app code, and return contexual values for the environment where the deployment is running.

Hydrogen automatically adds your environment variables to a request's context object. You can access the values of environment variables from a loader or action:

1. In your Hydrogen storefront, click Storefront settings.
2. Click Environments and variables.
3. Under Variables, click Add variable.
4. Under Key, type a key. It's a common convention for keys to use all-capital letters and underscores, such as EXAMPLE_API_TOKEN.
5. Under Value, add the value.
6. Optional: Check Make this value secret to hide the value after saving. This can be useful for sensitive information like API keys.
7. Under Environments, select the environments where the value should be returned.
8. Click Save.

Click Add another value to add additional values for other environments.

You can edit keys and values, as well as which environments they apply to.

1. In your Hydrogen storefront, click Storefront settings.
2. Click Environments and variables.
3. Click the environment variable to update.
4. Make your changes.
5. Click Save.

Deleting an environment variable deletes the key and all its associated values.

1. In your Hydrogen storefront, click Storefront settings.
2. Click Environments and variables.
3. Click the environment variable to delete.
4. Click Delete variable.
5. Click Delete variable to confirm.

Oxygen requires the following variables to query your store's data. They're automatically added when you create a storefront. Some variables are read-only, meaning they can’t be edited directly.

If your private Storefront API access token is exposed publicly, then you should rotate it to protect sensitive data and prevent abuse.

1. In your Hydrogen storefront, click Storefront settings.
2. Click Storefront API
3. Under Rotate private access token, click Generate new token
4. Click Generate new token to confirm.
5. Optional: If you have other client apps using your private API token, then update them with the new token value.
6. Under Past private access token, click Delete.
7. Push a commit to your GitHub repo to trigger a new deployment. At this time, Oxygen doesn't automatically re-deploy environments when rotating API tokens.

Oxygen deployments are immutable, which includes their environment variable values. This means any changes to environment variables don’t affect deployments that were made in the past.

If you create or update environment variables, then you need to push a commit in order to trigger a new deployment before your changes will take effect.

By default, environments are private, which means that you need to be logged into your store to view them. You can also make an environment public, meaning anyone with the URL can view it.

1. In your Hydrogen storefront, click Storefront settings.
2. Click Environments and variables.
3. Click the environment to edit.
4. Under URL privacy, select either Public or Private.
5. Click Save.

Stores have a limited number of public environments available, based on their plan.

Each environment has an automatically generated URL. By default, this URL always points to the most recent deployment to that environment.

• Learn how to deploy your Hydrogen storefront to Oxygen and other runtimes.