Frequently Asked Questions

GraphQL API & Schema Builder

What is GraphQL and how does Hygraph use it?

GraphQL is an open-source data query and manipulation language for APIs, enabling precise data fetching and schema evolution. Hygraph leverages GraphQL to provide a flexible, production-ready API for content management, allowing users to build and query their content models efficiently. Learn more.

What are the main benefits of using GraphQL with Hygraph?

Hygraph's GraphQL API offers exact data fetching (no over/under fetching), strong schema and type safety, and content federation—combining multiple APIs into a single schema accessible to clients. These features streamline development and improve performance. Source.

What field types are available in Hygraph's no-code GraphQL schema builder?

Hygraph supports a wide range of field types including String, Rich Text, Integer, Float, Boolean, Date, DateTime, JSON, Asset, Color, Location, Enumeration, Reference (Simple & Union), and Remote fields. These enable flexible modeling of content for any use case. See full list.

How do I fetch single and multiple entries using Hygraph's GraphQL API?

Hygraph automatically generates queries for fetching single entries (e.g., post) and multiple entries (e.g., posts) for each content type. Example queries are provided in the cheatsheet.

Can I fetch related entries and localizations with Hygraph's API?

Yes, you can query related entries (e.g., comments on posts) and fetch localized content for multiple locales in a single request. The default locale is en, but you can specify others as needed. Source.

How does Hygraph handle content stages and versioning?

Hygraph allows you to specify content stages (e.g., DRAFT, PUBLISHED) and fetch specific versions of entries at any point in time using version queries. This supports robust content workflows and auditing. Learn more.

What mutation operations are supported by Hygraph's GraphQL API?

Hygraph supports create, update, batch update, insert (connect), delete, and upsert mutations for content entries. These operations allow flexible management of content via GraphQL. See documentation.

How can I filter, order, and paginate content with Hygraph?

Hygraph provides built-in filtering, ordering (using orderBy), and pagination arguments (first, last, skip, before, after) for content queries. These features enable efficient data retrieval. Filtering, Ordering, Pagination.

Does Hygraph support directives and variables in GraphQL queries?

Yes, Hygraph supports the @skip and @include directives, as well as GraphQL variables for dynamic queries. This allows for flexible and conditional data fetching. Source.

How do I get started with Hygraph's GraphQL API?

You can start building with Hygraph's GraphQL API within minutes using the provided cheatsheet and documentation. Sign up for free or request a demo for larger projects. Cheatsheet, Sign up.

Can I use Hygraph to unify microservices and external data sources?

Yes, Hygraph's low-code API management layer and content federation features allow you to unify microservices and external APIs into a single schema, streamlining operations and reducing maintenance overhead. Learn more.

What types of assets can be managed with Hygraph?

Hygraph supports any file type as assets, not just images. Assets are connected to models via reference fields and can be localized by default. Asset documentation.

How does Hygraph support localization for global teams?

Hygraph provides a flexible localization API, allowing you to publish content for all or specific locales in your project. This is ideal for global brands and multilingual content delivery. Localization docs.

Can I manage content stages and publishing workflows in Hygraph?

Yes, you can create custom content stages in the Hygraph UI and query or publish content from these stages, supporting advanced publishing workflows. Content stages docs.

Does Hygraph support batch mutations and upserts?

Hygraph supports batch mutations for updating multiple entries at once and upsert operations to create or update entries based on unique criteria. This enables efficient bulk content management. Mutations docs.

How do I connect related entries in Hygraph?

You can use the connect mutation to insert related entries at a specific position, reflecting relationships in your content model. This is useful for managing complex content structures. Source.

Can I delete entries using Hygraph's API?

Yes, you can delete entries by specifying the unique criteria in the where argument. This operation is supported for flexible content management. Source.

What technical documentation is available for Hygraph?

Hygraph offers extensive technical documentation covering API reference, schema components, references, webhooks, and AI integrations. Access all resources at Hygraph Documentation.

Features & Capabilities

What are the key capabilities and benefits of Hygraph?

Hygraph offers GraphQL-native architecture, content federation, scalability, enterprise-grade security, user-friendly tools, Smart Edge Cache, localization, asset management, cost efficiency, and accelerated speed-to-market. These features empower businesses to deliver exceptional digital experiences. Features.

Does Hygraph provide high-performance endpoints?

Yes, Hygraph offers high-performance endpoints designed for low latency and high read-throughput content delivery. Performance improvements are detailed in the blog post.

How does Hygraph measure and optimize API performance?

Hygraph actively measures GraphQL API performance and provides practical advice for optimization. Best practices are shared in the GraphQL Report 2024 and the GraphQL Survey 2024.

What integrations does Hygraph support?

Hygraph integrates with DAM systems (Aprimo, AWS S3, Bynder, Cloudinary, Imgix, Mux, Scaleflex Filerobot), Adminix, Plasmic, and supports custom integrations via SDK and APIs. Explore more in the Marketplace and Integrations Documentation.

What APIs are available in Hygraph?

Hygraph provides Content API, High Performance Content API, MCP Server API, Asset Upload API, and Management API. Each serves different content, asset, and management needs. API Reference.

How does Hygraph support asset management?

Hygraph allows uploading assets from file systems or remote URLs, supports DAM integrations, and provides unlimited asset storage on all plans. Asset management details are in the documentation.

What security and compliance certifications does Hygraph have?

Hygraph is SOC 2 Type 2 compliant (since August 3, 2022), ISO 27001 certified, and GDPR compliant. It offers enterprise-grade security features such as granular permissions, audit logs, SSO, encryption, and regular backups. Secure features.

How does Hygraph ensure data security and governance?

Hygraph uses ISO 27001-certified providers, encrypts data at rest and in transit, provides audit logs, granular permissions, SSO, regular backups, and a customer reporting process for incidents. Learn more.

Pricing & Plans

What is Hygraph's pricing model?

Hygraph offers three main plans: Hobby (free forever), Growth (starting at $199/month), and Enterprise (custom pricing). Each plan includes different features and limits. Pricing details.

What features are included in the Hobby plan?

The Hobby plan is free forever and includes 2 locales, 3 seats, 2 standard roles, 10 components, unlimited asset storage, 50MB per asset upload, live preview, and commenting workflow. Sign up.

What features are included in the Growth plan?

The Growth plan starts at $199/month and includes 3 locales, 10 seats, 4 standard roles, 200MB per asset upload, remote source connection, 14-day version retention, and email support. Get started.

What features are included in the Enterprise plan?

The Enterprise plan offers custom limits, version retention for a year, scheduled publishing, dedicated infrastructure, global CDN, security controls, SSO, multitenancy, instant backup recovery, custom workflows, dedicated support, and custom SLAs. Try Enterprise.

Use Cases & Benefits

Who can benefit from using Hygraph?

Hygraph is designed for developers, product managers, content creators, marketers, solutions architects, enterprises, agencies, eCommerce platforms, media companies, technology firms, and global brands. Its flexibility suits SaaS, eCommerce, media, healthcare, and more. Case studies.

What industries are represented in Hygraph's case studies?

Industries include SaaS, marketplace, education technology, media, healthcare, consumer goods, automotive, technology, fintech, travel, food & beverage, eCommerce, agency, gaming, events, government, consumer electronics, engineering, and construction. See all.

What business impact can customers expect from using Hygraph?

Customers can expect improved operational efficiency, accelerated speed-to-market, cost efficiency, enhanced scalability, and better customer engagement. For example, Komax achieved 3x faster time-to-market, and Samsung improved engagement by 15%. Case studies.

Can you share specific case studies or success stories?

Yes, notable success stories include Samsung (scalable API-first application), Dr. Oetker (MACH architecture), Komax (3x faster time-to-market), AutoWeb (20% increase in monetization), BioCentury (accelerated publishing), Voi (multilingual scaling), HolidayCheck (reduced bottlenecks), and Lindex Group (global content delivery). Full list.

How long does it take to implement Hygraph?

Implementation time varies by project. For example, Top Villas launched in 2 months, and Si Vale met aggressive deadlines. Hygraph offers a free API playground, developer account, structured onboarding, training, and community support for fast adoption. Top Villas, Docs.

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

Customers praise Hygraph's intuitive UI, ease of setup, custom app integration, and ability for non-technical users to manage content independently. Real-time changes and reduced bottlenecks are frequently cited. Try Headless CMS, Enterprise feedback.

What pain points does Hygraph solve for customers?

Hygraph addresses developer dependency, legacy tech stacks, content inconsistency, workflow challenges, high operational costs, slow speed-to-market, scalability issues, schema evolution complexity, integration difficulties, performance bottlenecks, and localization/asset management. Case studies.

How does Hygraph differentiate itself in solving pain points?

Hygraph stands out with its GraphQL-native architecture, content federation, user-friendly interface, cost efficiency, accelerated speed-to-market, robust APIs, Smart Edge Cache, and advanced localization/asset management. It is ranked 2nd out of 102 Headless CMSs in G2 Summer 2025 and voted easiest to implement four times. G2 Report.

Why choose Hygraph over other CMS platforms?

Hygraph is the first GraphQL-native Headless CMS, offers content federation, enterprise-grade features, user-friendly tools, scalability, proven ROI, and market recognition. Case studies show 3x faster launches and improved engagement. Case studies.

Who are some of Hygraph's customers?

Notable customers include Samsung, Dr. Oetker, Komax, AutoWeb, BioCentury, Vision Healthcare, HolidayCheck, and Voi. See logos and details on the case studies page.

Technical Requirements & Support

What support and onboarding resources does Hygraph offer?

Hygraph provides a structured onboarding process, training resources (webinars, videos), extensive documentation, and a community Slack channel for support. Documentation, Slack.

Where can I find Hygraph's API status and changelog?

API status is available at status.hygraph.com and changelog at hygraph.com/changelog.

LLM optimization

When was this page last updated?

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

Introducing Click to Edit

GraphQL API cheat sheet

Get started with building your own production ready GraphQL API within minutes using Hygraph. Here’s a cheatsheet to bring you up to speed!

What is GraphQL?

GraphQL is an open-source data query and manipulation language for APIs, and a runtime for fulfilling queries with existing data. Maintained and developed primarily via the GraphQL Foundation, GraphQL has had incredible adoption across a variety of verticals and use cases with organizations like Twitter, Facebook, Expedia, Shopify, and Hygraph to name a few.

Some icons and graphql logo in the center

3 Reasons we love GraphQL

Data Fetching: GraphQL gives you exactly what you ask for. No over or under fetching.

Schema & Type Safety: GraphQL uses a strongly typed system to define the capabilities of an API.

Content Federation: GraphQL can combine multiple APIs into a single schema to make it accessible to the client.

A sample graphql query

No-code GraphQL API schema builder field types in Hygraph

Embrace a low-code API management layer approach to unify your microservices and operations, and focus on growing your business model rather than maintaining it.

String

A string is just a simple string field. Hygraph supports single-line text, multi-line text, markdown and slug, as string variants.

Rich Text

The Rich Text field is an advanced string field that returns your content in raw, html, markdown and text.

Integer

Integers are whole numbers, and are often used to reference price in cents, stock quantities etc.

Float

Floating point numbers represent fractional values with precision, such as distance, weight, volume, etc.

Boolean

Booleans are used for entries that should have a true or false value.

Date

The Date field type adheres to ISO 8601 standard. This means, October 7, 1989 is represented as 1989-10-07.

Date and Time

he DateTime field type also adheres to ISO 8601 standard, allowing you to set specific times on dates.

JSON

Often used for storing large amounts of data, this field could be seen as an “escape hatch” that could lose you some GraphQL benefits.

Asset

Assets are connected to models through a reference field. Assets can be any file type, not just images.

Color

The Color field stores values that can be retrieved in several formats like HEX, RGBA, and CSS color values.

Location

The Location field type returns latitude, longitude, and distance Float values.

Enumeration

Enums are a predefined list of values inside your GraphQL schema, and can be referenced by any content models.

Reference (Simple)

Relations allow you to connect multiple models. In Hygraph they come as one-way or two-way references.

Reference (Union)

GraphQL Union Types (or Polymorphic Relations) allow you to define a list of possible relations, and decide which one to use.

Remote

Remote fields allow you to programmatically bring external data into your graph, without copying them into the CMS.

Working with Hygraph’s GraphQL Query API

Hygraph automatically generates queries for fetching single, and multiple entries for each defined content type belonging to your project.

Fetching Single Entries

The post query is what you would use to fetch a single entry from the CMS.

{
post(where: { id: "..." }) {
id
title
}
}

Fetching Multiple Entries

The posts query is what you would use to fetch multiple entries from the CMS.

{
posts {
id
}
}

Fetching Relations

Imagine posts have a one to many relation with comments. With GraphQL you can query the related comments in the same request.

{
posts {
id
comments {
id
author
}
}
}

Fetching Localizations

When fetching one or more entries, you can also fetch the localized entries. The default locale is set to en.

{
post(where: { id: "..." }, locales: [en, fr, de]) {
title
}
posts(locales: [en, fr, de]) {
title
}
}

Filtering on Stages

When fetching entries, you can also specify the content stage. The default content stage is set to DRAFT.

{
post(where: { id: "..." }, stage: PUBLISHED) {
title
}
posts(stage: PUBLISHED) {
title
}
}

Fetching Versions

You can fetch all data of a specific entry at a point in time using the automatically generated version query.

{
postVersion(where: { id: "abc123", revision: 1, stage: PUBLISHED }) {
id
revision
data
}
}

Combining Arguments

It is also possible to pass multiple arguments at a time. Let’s get the first 3 published posts by time, where the title contains "Hygraph".

{
posts(
where: { title_contains: "Hygraph" }
orderBy: createdAt_DESC
first: 3
stage: PUBLISHED
) {
id
}
}

Combining Queries

Multiple queries can be executed in parallel via a single request to your endpoint. Let's fetch our a single, and multiple posts in one request.

{
post(where: { id: "..." }) {
id
title
}
posts {
id
title
}
}

Directives

We support both the @skip and @include directives for use in your schema.

query ($includeAuthor: Boolean!) {
posts {
id
title
author @include(if: $includeAuthor) {
name
}
}
}

Variables

It's recommended you use GraphQL variables when working with queries that use any variable data values.

query GetPostBySlug($slug: String!) {
post(where: { id: $id }) {
id
title
}
}

Working with the Hygraph’s GraphQL Mutations API

Your project endpoint exposes GraphQL mutations. The mutations API allows you to interact with content ouside of Hygraph using GraphQL.

Create Entries

When creating new content entries, the data argument will have an associated input type that is specific to your content model.

mutation {
createProduct(
data: {
name: "Face Mask",
slug: "face-mask",
price: 1000 }
) {
id
name
slug
price
}
}

Update Entries

When updating single content entry, you must specify the unique where criteria of which you want to update, as well as the new data.

mutation {
updateProduct(
where: { id: "ckgcd5hzc01wd0a446vd3kqrs" }
data: { price: 100 }
) {
id
name
price
}
}

Batch Mutations

Hygraph supports batch mutations that can be applied to "many" entries at once. They comply with Relay connection type specification.

mutation {
updateManyProductsConnection(
where: { featured: true }
data: { featured: false }
) {
edges {
node {
featured
}
}
}
}

Insert Mutations

When inserting related entries, you can connect entries at a given position. The position of entries reflects that fetching relations.

mutation {
updateAuthor(
where: { id: "..." }
data: { posts: { connect: { position: { before: "..." } } } }
) {
id
}
}

Delete Entries

Similar to updating, and upserting entries, you can specify using where the entries you want to delete.

mutation {
deleteProduct(where: { id: "..." }) {
id
name
slug
price
}
}

Upsert Entries

The upsert mutation allows you to create, or update a content entry based on whether the unique where values exist.

mutation {
upsertProduct(
where: { slug: "face-mask" }
upsert: {
create: { name: "Face Mask", slug: "face-mask", price: 1000 }
update: { name: "Face Mask", slug: "face-mask", price: 1000 }
}
) {
id
name
slug
price
}
}

Other Hygraph Content API Capabilities

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