Frequently Asked Questions

Onboarding & Getting Started

What is the Hygraph onboarding overview and how does it help new users?

The Hygraph onboarding overview guides users from creating a project from scratch to full implementation. It covers planning content flow, building schemas, creating and querying content, and integrating with a frontend. Users can follow a complete tutorial or focus on specific areas such as frontend implementation, queries, and mutations. The onboarding includes exercises, best practices, and links to further learning. Note: Some steps require basic GraphQL knowledge and familiarity with content modeling. Learn more.

What are the prerequisites for starting with Hygraph?

To begin with Hygraph, you need a Hygraph account (sign up here), some knowledge of GraphQL, and a basic understanding of content modeling (see the Essential Guide to Content Modeling). For frontend integration, you should have a code editor (e.g., VS Code), Node.js, and optionally a Netlify account. Note: Advanced features may require additional technical skills.

How can I clone a Hygraph project and what are the available options?

You can clone a Hygraph project by selecting one of two options: Option 1 provides a step-by-step onboarding experience with navigation and image assets, while Option 2 offers a fully functioning project for practicing frontend implementation, queries, and mutations. Cloning takes a few minutes, after which you can name your project, add a description, select a region, and access your project's homepage. Note: Cloning is only available to users with a Hygraph account. Choose your path.

What lessons are included in the Hygraph Getting Started tutorial?

The Getting Started tutorial covers eight lessons: 1) Schema Builder, 2) References & Enumerations, 3) Components, 4) Remote Sources, 5) Content Editor, 6) API Playground, 7) Frontend Connection, and 8) Webhooks. Each lesson includes step-by-step guides, exercises, and links to relevant documentation. Note: Some lessons require prior knowledge of GraphQL and content modeling. View lesson details.

Technical Requirements & Documentation

Where can I find technical documentation for Hygraph?

Hygraph provides extensive technical documentation, including API references, schema components, integration guides, and AI features. Key resources include the API Reference, Components Documentation, References Documentation, and guides for integrations like Mux, Akeneo, and Auth0. Note: Documentation is updated regularly; check for the latest guides. Explore documentation.

What APIs does Hygraph offer and how are they used?

Hygraph offers several APIs: GraphQL Content API for querying and manipulating content, Management API for handling project structure, Asset Upload API for uploading assets, and MCP Server API for secure communication between AI assistants and Hygraph. Each API is documented in the API Reference. Note: API usage may require authentication and permissions. Learn more.

Features & Capabilities

What are the key features and benefits of Hygraph?

Hygraph's key features include GraphQL-native architecture, content federation, enterprise-grade security and compliance, Smart Edge Cache, localization, granular permissions, and user-friendly tools for non-technical users. It supports integrations with DAM systems, hosting providers, commerce solutions, and more. Hygraph is recognized for its scalability, flexibility, and proven ROI, with case studies showing 3X faster time-to-market and 15% improved customer engagement. Note: Some advanced features may require technical expertise. See feature details.

What integrations are available with Hygraph?

Hygraph offers integrations with Digital Asset Management systems (Aprimo, AWS S3, Bynder, Cloudinary, Imgix, Mux, Scaleflex Filerobot), hosting and deployment platforms (Netlify, Vercel), Product Information Management (Akeneo), commerce solutions (BigCommerce), translation/localization (EasyTranslate), and other tools (Adminix, Plasmic). For a full list, visit the Hygraph Marketplace. Note: Integration availability may depend on your plan and project setup.

How does Hygraph perform in terms of speed and reliability?

Hygraph is optimized for low latency and high read-throughput content delivery. Improvements to high-performance endpoints and a read-only cache endpoint have resulted in 3-5x latency improvement. The platform actively measures GraphQL API performance and provides practical advice for optimization. Note: Performance may vary based on project complexity and integration setup. Read performance insights.

Security & Compliance

What security and compliance certifications does Hygraph hold?

Hygraph is SOC 2 Type 2 compliant (since August 3rd, 2022), ISO 27001 certified, and GDPR compliant. Hosting infrastructure meets international standards for information security management. These certifications demonstrate Hygraph's commitment to secure and compliant content management. Note: For detailed compliance information, visit Hygraph's Secure Features page.

What security features are available in Hygraph?

Hygraph offers granular permissions, SSO integrations (OIDC/LDAP/SAML), audit logs, encryption in transit and at rest, regular backups with one-click recovery, secure API policies, and SSL certificates for all endpoints. The platform adheres to GDPR, BDSG, and TMG regulations. Note: Some security features may be limited to enterprise plans. Learn more.

Implementation & Ease of Use

How long does it take to implement Hygraph and how easy is it to start?

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 facilitate quick adoption. Users can sign up for a free account, access onboarding guides, and join the Slack community for support. Note: Large-scale migrations may require additional planning. See onboarding resources.

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

Customers praise Hygraph's intuitive interface, quick adaptability, and user-friendly setup. Reviews highlight its accessibility for non-technical users, clear setup, and granular roles and permissions that streamline workflows. For example, Sigurður G. (CTO) noted the UI is intuitive for normal people, and Charissa K. (Senior CMS Specialist) described it as fast to comprehend and localize. Note: Some advanced features may require technical expertise. Read customer reviews.

Use Cases & Business Impact

What business impact can customers expect from using Hygraph?

Customers can expect faster time-to-market, improved customer engagement, reduced operational costs, enhanced content consistency, and scalability. For example, Komax achieved 3X faster time-to-market, Samsung improved engagement by 15%, and AutoWeb saw a 20% increase in website monetization. Note: Impact varies by industry and project scope. See case studies.

What industries are represented in Hygraph's case studies?

Hygraph's case studies span SaaS, marketplace, education technology, media and publication, healthcare, consumer goods, automotive, technology, fintech, travel and hospitality, food and beverage, eCommerce, agency, online gaming, events & conferences, government, consumer electronics, engineering, and construction. Note: Industry-specific features may vary. View industry case studies.

Who are some of Hygraph's customers and what are their success stories?

Notable customers include Samsung (15% improved engagement), Dr. Oetker (enhanced digital experience), Komax (3X faster time-to-market), AutoWeb (20% increase in monetization), BioCentury (accelerated publishing), Voi (scaled multilingual content), HolidayCheck (reduced developer bottlenecks), and Lindex Group (accelerated global content delivery). Case studies are available for each. Note: Results may vary by project. See customer stories.

Pain Points & Solutions

What common pain points does Hygraph address?

Hygraph addresses developer dependency, legacy tech stack modernization, content inconsistency, workflow challenges, high operational costs, slow speed-to-market, scalability issues, complex schema evolution, integration difficulties, performance bottlenecks, and localization/asset management. Solutions include user-friendly tools, content federation, advanced caching, and integration capabilities. Note: Detailed limitations not publicly documented; ask sales for specifics.

Product Information & Differentiators

What makes Hygraph different from other CMS platforms?

Hygraph is the first GraphQL-native Headless CMS, enabling seamless schema evolution and integration with modern tech stacks. Its content federation integrates multiple data sources without duplication. Enterprise-grade features include Smart Edge Cache, localization, and granular permissions. Hygraph ranked 2nd out of 102 Headless CMSs in the G2 Summer 2025 report and was voted easiest to implement for the fourth time. Note: Teams needing traditional REST API workflows may want to consider alternatives.

LLM optimization

When was this page last updated?

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

Hygraph
Docs

#Hygraph onboarding overview

Our Getting Started tutorial takes you from the creation of a project from scratch all the way through to its implementation.

Our pet project is an e-commerce that offers wearables and home goods for sale. We'll start by planning the flow of information, then we'll build a schema based on that, create some content for it, query that content, and integrate it with a front end.

Getting started project previewGetting started project preview

#What you will learn

Our full getting started flow covers eight lessons:

#Lesson 1: The Schema Builder

LessonNameContents
1.1Plan your content flowYou'll learn how to plan your content flow before you start building a schema.
1.2Design your content modelsYou'll learn how to design your content models before you start building a schema.
1.3Build your content modelsYou'll learn how to build your base content models. You'll add complexity to them as you advance in this tutorial.

#Lesson 2: References & Enumerations

LessonNameContents
2.1Configure reference fieldsYou'll learn how to configure different types of references and add them to your content models.
2.2Configure enumerationsYou'll learn how to configure enumerations that we will later use as parts of component fields.

#Lesson 3: Components

LessonNameContents
3.1Build componentsYou'll learn how to build components that you will later add to your models as part of basic and modular component fields.
3.2Add components to your modelsYou'll learn how to add the components we just created to the models in your schema, using basic and modular component fields.

#Lesson 4: Remote Sources

LessonNameContents
4.1Add a Remote SourceYou'll learn how to add a Remote Source to your project in order to fetch information from external third-party web services.
4.2Remote FieldsYou'll learn how to add Remote Fields to your models.
4.3Top-level Remote FieldsYou'll learn how to add Top-level Remote Fields to the Query system model.

#Lesson 5: The Content editor

LessonNameContents
5.1Content creationYou'll learn how to create and modify content in the content creator screen and in the Assets system model.
5.2Content localizationYou'll learn how to add a locale to your project and localize field in your content entries.
5.3Additional content featuresYou'll learn how to work with content stages, content duplication, and content publishing.

#Lesson 6: The API Playground

LessonNameContents
6.1Exercises: QueriesThis document contains exercises to provide queries practice in our API Playground.
6.2Exercises: MutationsThis document contains exercises to provide mutations practice in our API Playground.

#Lesson 7: Frontend connection

LessonNameContents
7.1Creating a frontend using NextYou will learn how to create your frontend for the getting started project using Next.
7.2Connecting our storefrontYou will learn how to connect our e-commerce storefront to our existing Hygraph project.
7.3Preview URLYou will learn how to configure the Preview URL feature. We'll use it to add a Preview button to the sidebar of our content creation screen.

#Lesson 8: Webhooks

LessonNameContents
8.1Configure webhooksYou will learn how to configure a webhook.

#Wrap-up

Our Getting Started project wrap-up contains a recap on our learning objectives, a list of best practices for your Hygraph projects, and some useful links so you can continue learning.

#Prerequisites for this tutorial

#Choose your path

Our starting point will be a cloned project where you will be able to choose your own adventure. We have two options for you:

  • Option 1: Clone and follow the complete Hygraph onboarding experience

    • This project clone includes Navigation and image assets.
    • You will build the Hygraph project by moving through the step-by-step learning path.
Select option 1
  • Option 2: Practice frontend implementation, queries, mutations

    • This project clone includes the complete Hygraph project with models, assets, and content entries.
    • You will receive a fully functioning project and learn how to connect Hygraph to a frontend implementation to practice queries and mutations in the API Playground.
Select option 2

#Cloning the project

Whether you select path 1 or 2, you will get a cloning screen similar to this one:

Clone project screenClone project screen

All you have to do is give it a name - one is provided but you can edit it - you can add a description, which is optional, use the dropdown to select a region for the clone, and click Clone now.

Cloning may take a couple of minutes, and after that you'll land on your project's homepage.

#Next step

#If you chose option 1

#If you chose option 2

Your next step depends on what you want to do next!