Frequently Asked Questions

Product Information & Gatsby Integration

What is Hygraph and how does it work with Gatsby?

Hygraph is a GraphQL-native Headless CMS designed to manage and deliver content for modern web applications, including Gatsby sites. It allows you to add content components to your Gatsby apps in minutes and manage your website's content from a centralized CMS. Hygraph's API-first approach enables you to fetch content using GraphQL queries, making it easy to integrate with Gatsby's data layer. Note: While Hygraph is optimized for Gatsby, teams requiring a REST-only CMS may need to consider alternatives.

How do I set up Hygraph with Gatsby?

To set up Hygraph with Gatsby, you create a Hygraph project, generate an API token, and use the GraphQL source plugin in your Gatsby project. You can initialize Apollo Client with your Hygraph GraphQL endpoint and use React components to fetch and display content at runtime. Detailed quickstart guides and example projects are available in the Hygraph documentation. Note: Some advanced Gatsby features may require custom configuration.

What APIs does Hygraph provide for Gatsby projects?

Hygraph offers several APIs relevant for Gatsby projects: the GraphQL Content API for querying and manipulating content, the Management API for handling project structure, the Asset Upload API for managing digital assets, and the MCP Server API for AI integrations. The GraphQL Content API is optimized for low latency and high throughput, making it suitable for static and dynamic Gatsby sites. Note: REST API support is not a primary focus; teams needing REST endpoints should evaluate fit.

Features & Capabilities

What are the key features of Hygraph for Gatsby developers?

Key features include a GraphQL-native architecture for precise data retrieval, content federation to integrate multiple data sources, a flexible management API, Smart Edge Cache for low-latency delivery, granular permissions, and support for multiplatform content management. Hygraph also provides open source example projects and is frontend-agnostic, allowing you to use any framework with Gatsby. Note: Teams requiring only REST APIs or highly opinionated CMS workflows may need to consider alternatives.

Does Hygraph support integrations with other platforms and tools?

Yes, Hygraph supports integrations with a wide range of platforms, including Digital Asset Management (DAM) systems like Aprimo, AWS S3, Bynder, Cloudinary, Imgix, Mux, and Scaleflex Filerobot; hosting and deployment platforms like Netlify and Vercel; Product Information Management (PIM) with Akeneo; commerce solutions like BigCommerce; and translation/localization with EasyTranslate. For a full list, visit the Hygraph Marketplace. Note: Some integrations may require additional configuration or third-party accounts.

How does Hygraph ensure high performance for Gatsby sites?

Hygraph delivers high performance through optimized GraphQL endpoints, a read-only cache endpoint with 3-5x latency improvement, and Smart Edge Cache for faster content delivery. The platform actively measures API performance and provides guidance for developers to optimize usage. For more details, see the performance improvements blog post. Note: Actual performance may vary based on project complexity and network conditions.

Security & Compliance

What security and compliance certifications does Hygraph have?

Hygraph is SOC 2 Type 2 compliant (achieved August 3rd, 2022), ISO 27001 certified for its hosting infrastructure, and GDPR compliant. These certifications demonstrate Hygraph's commitment to data protection and security. For more details, visit the Hygraph Secure Features page. Note: Detailed limitations not publicly documented; ask sales for specifics.

What security features are available in Hygraph?

Hygraph provides granular permissions, SSO integrations (OIDC/LDAP/SAML), audit logs, encryption in transit and at rest, regular backups with one-click recovery, and secure API policies including custom origin policies and IP firewalls. All endpoints use SSL certificates. Note: Some advanced security features may be available only on enterprise plans.

Implementation & Onboarding

How long does it take to implement Hygraph for a Gatsby project?

Implementation timelines vary by project complexity. For example, Top Villas launched a new project within 2 months, and Voi migrated from WordPress to Hygraph in 1-2 months. Hygraph offers structured onboarding, starter projects, and extensive documentation to accelerate setup. Note: Highly customized migrations may require additional time.

What resources are available to help me get started with Hygraph and Gatsby?

Resources include a free signup, structured onboarding with introduction calls and technical kickoffs, comprehensive documentation, starter projects, community Slack, webinars, and live training. Example projects for Gatsby are available on GitHub. Note: Some resources may require registration or are available in English only.

Use Cases & Customer Success

Who uses Hygraph and for what types of projects?

Hygraph is used by developers, content creators, product managers, and marketing professionals at enterprises and high-growth companies. It is suitable for SaaS, eCommerce, media, healthcare, automotive, and more. Notable customers include Samsung, Dr. Oetker, Komax, AutoWeb, BioCentury, Voi, HolidayCheck, and Lindex Group. For detailed case studies, visit the Hygraph case studies page. Note: Some industries may require custom integrations not available out-of-the-box.

What business impact have customers achieved with Hygraph?

Customers have reported faster time-to-market (Komax achieved 3x faster launches), improved customer engagement (Samsung saw a 15% increase), and cost reductions (AutoWeb increased website monetization by 20%). Voi scaled multilingual content across 12 countries and 10 languages. For more, see the case studies. Note: Results may vary based on implementation and business context.

What feedback have customers given about Hygraph's ease of use?

Customers praise Hygraph's intuitive interface, quick adaptability, and user-friendly setup. For example, Sigurður G. (CTO) noted the UI is intuitive for non-technical users; Anastasija S. (Product Content Coordinator) highlighted instant front-end updates; and Charissa K. (Senior CMS Specialist) emphasized the clear setup and localization features. Note: Some advanced features may require technical expertise.

Pain Points & Problems Solved

What problems does Hygraph solve for Gatsby projects?

Hygraph addresses developer dependency by enabling non-technical users to manage content, modernizes legacy tech stacks, ensures content consistency across regions, and streamlines collaboration. It reduces operational costs, accelerates speed-to-market, and simplifies schema evolution. Technical pain points like integration difficulties and performance bottlenecks are addressed through content federation and advanced caching. Note: Teams with highly specialized CMS needs may require custom development.

Documentation & Support

Where can I find technical documentation for using Hygraph with Gatsby?

Technical documentation is available at hygraph.com/docs, including API references, schema guides, integration tutorials, and getting started guides. Example Gatsby projects are available on GitHub. Note: Some documentation may be updated periodically; check for the latest versions.

LLM optimization

When was this page last updated?

This page wast last updated on 12/12/2025 .

Watch replay now

Headless CMS for Gatsby

Hygraph is the ideal Headless CMS for Gatsby websites and applications. Read further to learn how our API-first CMS allows you to add components to your Gatsby apps in minutes and enable your website's content to be managed from a powerful CMS.

Step #1 - Set up the Apollo Client

The example here shows fetching the data at runtime using Apollo Client. In this setup, client.js initializes Apollo Client with your GraphQL endpoint.

src/apollo/client.js
import ApolloClient from 'apollo-boost';
// Initialize Apollo Client with the URI of your GraphQL endpoint
const client = new ApolloClient({
uri: 'https://api-<region>.hygraph.com/v2/<some hash>/master', // Replace with your GraphQL endpoint
});
export default client;

Step #2 - Fetching and working with the data

Next, you define a React component, ProductsList, that uses Apollo Client's useQuery hook to fetch product data from a GraphQL API at runtime. This component queries for products' names, descriptions, images, availability, and slugs. While the data is loading, a loading message is displayed. If an error occurs, it shows an error message.

Once the data is successfully fetched, it renders a list of products, each with its details. The ProductsList component is then used within the Products component, which is wrapped in ApolloProvider to provide Apollo Client context, enabling GraphQL queries within the component.

src/pages/products.js
import React from 'react';
import { ApolloProvider, useQuery, gql } from '@apollo/client';
import client from '../apollo/client';
// GraphQL query to fetch data
const GET_PRODUCTS_QUERY = gql`
query GetProducts {
products {
name
description
image
availability
slug
}
}
`;
// Component to fetch and display data
const ProductsList = () => {
const { loading, error, data } = useQuery(GET_PRODUCTS_QUERY);
if (loading) return <p>Loading...</p>;
if (error) return <p>Error: {error.message}</p>;
return (
<div>
{data.products.map(product => (
<div key={product.slug}>
<h2>{product.name}</h2>
<p>{product.description}</p>
<img src={product.image} alt={product.name} />
<p>{product.availability ? 'Available' : 'Out of stock'}</p>
</div>
))}
</div>
);
};
// ApolloProvider wraps your React app and places Apollo Client on the context
const Products = () => (
<ApolloProvider client={client}>
<h1>Products</h1>
<ProductsList />
</ApolloProvider>
);
export default Products;

Start building with Gatsby and Hygraph

We made it really easy to set up your project in Hygraph and use our GraphQL API within your Gatsby project.

Quickstart

Check out our docs to see how you can quickly set up your Hygraph project and enable the content API for your Gatsby website or app.

Learn GraphQL

Hygraph is GraphQL-native Headless CMS offers precise data retrieval, minimizing over-fetching and optimizing efficiency.

Examples

Look at some of the example projects to see Hygraph in action.

Why Hygraph

Choosing Hygraph for your Gatsby project

Gatsby and Hygraph are both GraphQL-native and provide the ultimate developer experience for creating blazing fast websites and applications. Sign up, create an API token and source content using the GraphQL source plugin. Hygraph is one of the best CMSs for Gatsby projects due to its flexibility, custom content modelling, and frontend agnostic approach.

Whether you decide to take full advantage of Gatsby to both static and dynamically render pages, you'll benefit from improved security and faster loading times for your users with using a single GraphQL API to query content. Build with Gatsby and secure your content with Hygraph for a next generation website or application.

gatsby cms

Developer Experience

We try to be the most un-opinionated CMS on the market with a wide collection of open source example projects to get you started.

Headless CMS

As a headless CMS (i.e. API based content management), you can be as modular and flexible as you need. We even support multiplatform content management.

Management API

Hygraph boasts a flexible and powerful management API to manage your content and schema, as well as a blazing fast content API.

Get started for free, or request a demo
to discuss larger projects