Skip to main content

Data sources

tip

Hydrogen 2.0 is out now. These archival Hydrogen 1.0 docs are provided only to assist developers during their upgrade process. Please migrate as soon as possible.

Hydrogen contains a set of Shopify-specific commerce components, hooks, and utilities that help accelerate your development process. This guide describes how Hydrogen consumes data from different sources.

How it works

Hydrogen supports data coming from Shopify and third-parties:

A diagram that shows how Hydrogen consumes data

Shopify data source

Hydrogen is built and optimized to use data coming from Shopify's Storefront API. The shape of the data passed to components, hooks, and utilities corresponds and conforms to the structure based on the GraphQL types from the Storefront API.

You can pass data from the Storefront API directly into components, hooks, and utilities.

For example, the ProductOptionsProvider component expects product data to have the following structure, which corresponds to the Product object type returned from the Storefront API:

{
"id": "<string>",
"handle": "<string>",
"title": "<string>",
"description": "<string>",
"descriptionHtml": "<string>",
...
}

Third-party data sources

Hydrogen can also support data from third-party sources. If you want to use Hydrogen components with a third-party data source, then data from the third-party source must first be transformed into the types expected by the Hydrogen components, hooks, and utilities, and then passed on to the components, hooks, and utilities. Learn more about working with third-party data sources.

Next steps