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 .