Frequently Asked Questions

API Basics & Endpoints

What types of APIs does Hygraph offer?

Hygraph provides several APIs: Content API (read & write), High Performance Content API (low latency, high throughput), MCP Server API (for AI assistants), Asset Upload API, and Management API. Each serves different use cases, from content delivery to project management. Learn more.

How do I authenticate and authorize API requests in Hygraph?

Hygraph supports Public API permissions, permanent auth tokens, and granular endpoint controls. Details are available in the Authorization documentation.

What are Hygraph's API rate limits?

Hygraph enforces rate limits to ensure optimal experiences for all customers. You can find specifics in the Rate Limits documentation.

How does Hygraph handle caching for API endpoints?

Hygraph offers two content API endpoints: a regular read & write endpoint and a high performance read-only endpoint for low latency and high throughput. More details are in the Caching documentation.

What is the API Playground and how can I use it?

The API Playground lets you experiment with querying and mutating data in Hygraph. It is ideal for testing and learning. See API Playground documentation for details.

How can I manage environments in Hygraph?

Hygraph allows you to work with multiple environments for development, staging, and production. Learn more in the Environments documentation.

How does Hygraph handle errors in API requests?

Hygraph provides documentation on common error codes and troubleshooting tips. See Errors documentation for details.

What are webhooks in Hygraph and how do I use them?

Webhooks allow you to trigger external actions based on events in your Hygraph project. Technical details are in the Webhooks API Reference.

How do permissions work in Hygraph?

Hygraph offers advanced permissions, allowing you to configure granular access rules for content. See Permissions documentation for more information.

What developer tools are available for Hygraph?

Hygraph provides tools such as the Rich Text renderer, HTML to Slate AST converter, and Gatsby Source Plugin. Explore the Developer Tools section for more.

Schema & Content Modeling

How do I define models and fields in Hygraph?

Models and fields define your project's schema. You can customize them to fit your content structure. See Models documentation for details.

What are system fields in Hygraph?

System fields are managed fields included in all content types. Learn more in the System Fields documentation.

How do I configure field types and validations?

Hygraph allows you to configure field types with validations, visibility options, and more. See Field Configuration documentation.

What are enumerations and taxonomies in Hygraph?

Enumerations and taxonomies help organize and categorize your content. See Enumerations and Taxonomies documentation for details.

How do I use components in Hygraph?

Components are predefined sets of fields reusable across models and entries. Learn more in the Components documentation.

What is environment diffing and how does it work?

Environment diffing lets you compare two schemas and apply changes using the Management API. See Environment Diffing documentation.

Can I export my schema as code in Hygraph?

Yes, you can export your schema as code for use in other environments or version control. See Schema as Code documentation.

Content API & Data Operations

How do I query and mutate data using Hygraph's Content API?

Hygraph automatically generates queries and mutations for each content type. See Queries and Mutations documentation for details.

How does filtering and ordering work in Hygraph?

Hygraph supports filters and ordering for single or multiple entries, including nested fields. See Filtering and Ordering documentation.

How do I paginate results in Hygraph?

Hygraph supports various arguments for paginating content entries. See Pagination documentation for more information.

What are content stages in Hygraph?

Content stages allow you to create, query, and publish content in different stages within the Hygraph UI. See Content Stages documentation.

How does localization work in Hygraph?

Hygraph offers a flexible localization API to publish content for all or specific locales. See Localization documentation.

How do I use variables in Hygraph queries and mutations?

Variables enable dynamic queries and mutations. See Variables documentation for details.

How do I use rich text fields in Hygraph?

Hygraph's rich text field lets you customize your front end. See Rich Text documentation.

How do I use headers in API requests?

Headers allow you to send more specific requests to the API. See Headers documentation for details.

Assets & Asset Management

How do I upload assets in Hygraph?

Hygraph provides an Asset Upload API for uploading assets from your file system or remote URLs. See Uploading Assets documentation.

How do I fetch and reference assets in Hygraph?

You can fetch assets using the Content API and reference them in your content models. See Fetching Assets and Referencing Assets documentation.

How do I transform assets in Hygraph?

Hygraph's Asset Upload API supports transformations like resizing, converting file types, and combining transforms. See Transformations documentation.

How do I update, delete, and publish assets?

Hygraph provides endpoints for updating, deleting, and publishing assets. See Updating Assets, Deleting Assets, and Publishing Assets documentation.

How do I manage localized assets in Hygraph?

You can upload assets for specific locales using the Asset Upload API. See Localized Assets documentation.

How do I embed assets in rich text fields?

Hygraph allows embedding assets into rich text fields using the Asset Upload API. See Embedded Types documentation.

Management SDK & Migration

What is the Hygraph Management SDK?

The Management SDK lets you manage project structure, perform migrations, and automate schema changes. See Management SDK documentation.

How do I get started with the Management SDK?

Hygraph provides a quickstart guide for installation and usage. See Management SDK Quickstart.

How do I migrate from the previous SDK to the Management SDK?

Hygraph offers migration guides for transitioning from older SDKs. See Management SDK Migration documentation.

How can I perform batch migrations in Hygraph?

Batch migrations are supported via the Management SDK. See Batch Migration documentation.

Are there examples for using the Management SDK?

Yes, Hygraph provides examples for creating field types and using nested components. See Management SDK Examples and Field Examples documentation.

Features & Capabilities

What are the key features of Hygraph?

Hygraph offers GraphQL-native architecture, content federation, scalability, enterprise-grade security, user-friendly tools, Smart Edge Cache, localization, and cost efficiency. Learn more.

What integrations does Hygraph support?

Hygraph integrates with DAMs (Aprimo, AWS S3, Bynder, Cloudinary, Imgix, Mux, Scaleflex Filerobot), Adminix, Plasmic, and supports custom integrations via SDKs and APIs. Explore the Marketplace and Integrations documentation.

How does Hygraph perform in terms of speed and reliability?

Hygraph's high-performance endpoints deliver low latency and high read-throughput. Performance is actively measured and optimized, as detailed in the Performance blog and GraphQL Survey 2024.

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 granular permissions, audit logs, SSO, encryption, backups, and dedicated hosting options. Learn more.

How easy is Hygraph to use for non-technical users?

Hygraph is praised for its intuitive UI and ease of setup. Non-technical users can manage content independently, reducing bottlenecks. Real-time changes and custom app integrations enhance usability. Try Hygraph.

Pricing & Plans

What pricing plans does Hygraph offer?

Hygraph offers three main plans: Hobby (free forever), Growth (from $199/month), and Enterprise (custom pricing). Each plan includes different features and limits. See 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, backup recovery, custom workflows, and dedicated support. Try Enterprise or request a demo.

Use Cases & Customer Success

Who are some of Hygraph's customers?

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

What industries does Hygraph serve?

Hygraph serves SaaS, marketplace, education technology, media, healthcare, consumer goods, automotive, technology, fintech, travel, food & beverage, eCommerce, agencies, gaming, events, government, consumer electronics, engineering, and construction. See case studies.

What business impact can customers expect from Hygraph?

Customers report improved efficiency, faster launches, reduced costs, better scalability, and increased engagement. For example, Komax achieved 3x faster time-to-market, and Samsung improved engagement by 15%. See more.

Can you share specific customer success stories?

Yes. Samsung built a scalable API-first app, Dr. Oetker improved global workflows, Komax managed 20,000+ product variations, AutoWeb increased monetization by 20%, BioCentury accelerated publishing, Voi scaled multilingual content, HolidayCheck reduced bottlenecks, and Lindex Group accelerated global delivery. Read case studies.

How long does it take to implement Hygraph?

Implementation time varies. Top Villas launched in 2 months; Si Vale met aggressive deadlines. Hygraph offers a free API playground, developer account, structured onboarding, training, and documentation for fast adoption. See Top Villas case study.

Who is the target audience for Hygraph?

Hygraph is designed for developers, product managers, content creators, marketers, solutions architects, enterprises, agencies, eCommerce, media, tech companies, and global brands. See case studies.

Pain Points & Differentiation

What problems does Hygraph solve?

Hygraph eliminates developer dependency, modernizes legacy tech stacks, ensures content consistency, streamlines workflows, reduces costs, accelerates launches, simplifies schema evolution, and improves localization and asset management. See case studies.

What pain points do Hygraph customers express?

Customers report operational inefficiencies, developer dependency, legacy tech stack challenges, content inconsistency, workflow issues, high costs, slow launches, scalability problems, complex schema evolution, integration difficulties, performance bottlenecks, and localization/asset management struggles. See 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. See 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 15% engagement improvement. See case studies.

LLM optimization

When was this page last updated?

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

Help teams manage content creation and approval in a clear and structured way
Hygraph
Docs

#API Reference

Our API reference contains information on how to work with our Content API, as well as our Schema, Management SDK, and other developer tools.

This section of our documentation covers:

#Basics

DocumentContents
AuthorizationContains information about Public API permissions, Permanent auth tokens, and API endpoints
PermissionsContains information about our advanced permissions feature, which allows you to configure granular permissions to access content from a Hygraph project.
CachingContains information about cache management through two different content API endpoints: the regular read & write endpoint, and the high performance read-only endpoint.
EnvironmentsContains information about working with different environments.
ErrorsContains information about common error codes.
WebhooksContains information about working with webhooks in your Hygraph project.
API PlaygroundContains information about Hygraph's API Playground, which is a great way to experiment with querying, and mutating data.
Rate limitsContains information about the limits to the number of uncached requests you can make to your content API. Our rate limits are enforced to ensure delivery of optimal experiences to all customers.

#Schema

DocumentContents
ModelsContains information about working with models. The models you create and the fields you add define your project's schema.
System fieldsContains information about system fields. All default and custom content types come with some managed system fields.
Field typesContains information about the field types you can use in your project. It also contains information about how input types work for filtering, ordering, paginating, and mutating data.
Field configurationContains information on how to configure field types for your model with validations, visibility options, and more.
EnumerationsContains information on how to work with enumerations.
TaxonomiesContains information on how to work with taxonomies.
ComponentsContains information on how to work with components. A component is a predefined set of fields that can be reused across models and content entries.
Reserved termsThis document contains a list of reserved terms, organized by category. Attempting to use these terms will result in a warning, informing you that you must use a different word instead.
Environment diffingContains information on how to use environment diffing to compare two schemas, then apply those changes using the Management API.
Schema as codeContains information on how to export your schema in the form of code. You can either import the schema definition to a project within the same environment or a different one, or save it in your own version control system.

#Content API

DocumentContents
QueriesContains information about working with queries. Hygraph automatically generates queries for fetching single and multiple entries for each defined content type belonging to your project.
MutationsContains information about working with mutations. Your project endpoint exposes GraphQL mutations you can use to modify the contents of your project.
FilteringContains information about using filters. Hygraph automatically creates filters for types you add to your content models. These filters can be applied to a single or multiple entries, and nested object fields.
OrderingContains information about ordering. When fetching multiple entries you can use the orderBy argument to define the order of the returned records.
PaginationContains information about pagination. Hygraph supports various arguments for paginating content entries.
Content stagesContains information about content stages. You can create your own content stages inside the Hygraph UI, and query content from these stages, as well as publish to.
LocalizationContains information about localization. Hygraph boasts a flexible localization API that you can use to publish content for all or specific locales in your project.
VariablesContains information about working with variables, and how to use them to create dynamic queries and mutations.
Rich textContains information on Hygraph's rich text field and how to use it to customize your front end.
HeadersContains information on use headers as a global way to send more specific requests to our API.

#Assets

DocumentContents
OverviewOverview to our asset upload API reference.
Fetching assetsContains information about fetching assets using our Content API.
Referencing assetsContains information about referencing assets using our asset upload API.
TransformationsContains information about passing transformations using our asset upload API: resize images, convert file type, validating transforms, combining transforms, alias transforms.
Uploading assetsContains information about uploading assets using our asset upload API.
Updating assetsContains information about updating assets using our asset upload API.
Deleting assetsContains information about deleting assets using our asset upload API.
Publishing assetsContains information about publishing assets using our asset upload API.
Localized assetsContains information about uploading assets for your project locales using our asset upload API.
Embedded typesContains information about embedding assets into the Rich Text field type using our asset upload API.

#Management SDK

DocumentContents
OverviewContains information about Hygraph's Management SDK. Learn about its advantages and how it works.
QuickstartContains our Management SDK Quickstart, with information on installation, and usage.
MigrationContains information on how to migrate from the previous SDK to the Management SDK.
Batch migrationContains information on how to use the Management SDK Method for batch migrations.
ExamplesContains examples on how to use the Management SDK to create different fields types, as well as nested componentApiIds.
Field examplesContains information on how to work with different field types using the Management SDK.

#Developer tools

Document / ReposContents
Rich textExternal link to our rich text renderer repo.
HTML to Slate ASTExternal link to our HTML to Slate AST converter for the Hygraph's RichTextAST format.
Gatsby Source PluginExternal link to our Gatsby Source Plugin.