Skip to main content
Anchor to HydrogenStorefrontCustomerUserError

HydrogenStorefrontCustomerUserError

object

Requires Request must be initiated from the Shopify CLI and user must have full access to apps or access to the Hydrogen channel.

Catches validation errors when setting up customer authentication for your Hydrogen storefront, so you can quickly fix configuration issues and get customers logging in smoothly.

For example, when setting invalid redirect URLs or JavaScript origins that don't meet security requirements, this error type captures the specific validation failure with clear guidance for resolution.

Use HydrogenStorefrontCustomerUserError to:

  • Handle customer account configuration errors
  • Display specific validation messages for authentication setup
  • Identify problematic URL or origin configurations
  • Guide developers through Customer Account API requirements

Each error includes the field that failed validation and a descriptive message explaining the specific requirement, making it easier to troubleshoot customer authentication setup.

Learn more about Customer Account API configuration.

Anchor to FieldsFields

Anchor to codecode
•HydrogenStorefrontCustomerUserErrorCode

The error code.

Anchor to fieldfield
•[String!]

The path to the input field that caused the error.

Anchor to messagemessage
•String!
non-null

The error message.

Was this section helpful?

Anchor to MutationsMutations

Anchor to hydrogenStorefrontCustomerApplicationUrlsReplacehydrogenStorefrontCustomerApplicationUrlsReplace
•mutation

Updates the customer account application URLs for a Hydrogen storefront, configuring the authentication and redirect endpoints used by Shopify's Customer Account API integration. This mutation validates URL formats and security requirements.

For example, when setting up customer login functionality, developers configure the JavaScript origin for client-side authentication, logout redirect URIs for post-signout navigation, and the primary redirect URI for successful authentication flows.

Use hydrogenStorefrontCustomerApplicationUrlsReplace to:

  • Configure customer authentication endpoints
  • Update redirect URLs for login and logout flows
  • Modify JavaScript origins for client-side integration
  • Validate URL security and format requirements

The mutation replaces all existing URLs with the new configuration, ensuring consistent authentication behavior across the storefront. Detailed error reporting helps developers verify the configuration meets Shopify's security standards.

Learn more about Customer Account API integration.

Was this section helpful?

Anchor to InterfacesInterfaces

Was this section helpful?