---
title: HydrogenStorefrontEnvironmentVariableBulkReplacePayload - GraphQL Admin
description: Return type for `hydrogenStorefrontEnvironmentVariableBulkReplace` mutation.
api_version: unstable
api_name: admin
source_url:
  html: https://shopify.dev/docs/api/admin-graphql/unstable/payloads/hydrogenstorefrontenvironmentvariablebulkreplacepayload
  md: https://shopify.dev/docs/api/admin-graphql/unstable/payloads/hydrogenstorefrontenvironmentvariablebulkreplacepayload.md
---

# Hydrogen​Storefront​Environment​Variable​Bulk​Replace​Payload

payload

Return type for `hydrogenStorefrontEnvironmentVariableBulkReplace` mutation.

## Fields

* user​Errors

  [\[Environment​Variables​User​Error!\]!](https://shopify.dev/docs/api/admin-graphql/unstable/objects/EnvironmentVariablesUserError)

  non-null

  The list of errors that occurred from executing the mutation.

***

## Mutations with this payload

* [hydrogen​Storefront​Environment​Variable​Bulk​Replace](https://shopify.dev/docs/api/admin-graphql/unstable/mutations/hydrogenStorefrontEnvironmentVariableBulkReplace)

  mutation

  Replaces all environment variables for a specific Hydrogen storefront environment in a single atomic operation. This mutation provides a complete replacement strategy rather than individual variable updates, ensuring consistent environment configuration.

  For example, when deploying a new version of your Hydrogen storefront that requires a different set of API keys, database URLs, and feature flags, you can replace the entire environment configuration at once rather than updating variables individually.

  Use `HydrogenStorefrontEnvironmentVariableBulkReplace` to:

  * Deploy complete environment configurations during releases
  * Synchronize development and production environment settings
  * Reset environment variables to a known baseline state
  * Migrate between different configuration schemas

  This bulk replacement approach helps prevent configuration drift and ensures all related variables are updated together, reducing the risk of partial updates that could break your storefront functionality.

  Learn more about [Hydrogen deployment](https://shopify.dev/docs/custom-storefronts/hydrogen/deployment).

***

## Map

### Mutations with this payload

* [hydrogen​Storefront​Environment​Variable​Bulk​Replace](https://shopify.dev/docs/api/admin-graphql/unstable/types/hydrogenStorefrontEnvironmentVariableBulkReplace)