Frequently Asked Questions
API Rate Limits & Technical Usage
What are the API rate limits for Hygraph?
Hygraph enforces rate limits on all GraphQL queries for shared regions to ensure optimal experiences for all customers. The default uncached request limits are: Hobby: 5 requests/sec, Growth: 25 requests/sec, Enterprise: up to 500 requests/sec. There are no limits enforced on requests that hit the CDN cache. (Source: Hygraph Rate Limits Docs)
What happens if I exceed my rate limit on Hygraph?
If you exceed your rate limit, you will receive a 429 error (Too Many Requests). This error indicates that you have made more uncached requests than your plan allows. (Source: Hygraph Error Docs)
Are cached requests subject to rate limits in Hygraph?
No, cached requests are not rate limited. Only uncached requests that fetch content from the database are subject to rate limits. (Source: Hygraph Rate Limits Docs)
How can I handle rate limits in Next.js when using Hygraph?
You can use the experimental workerThreads: false setting in your next.config.js to disable multithreading and throttle API calls. Additionally, using libraries like pThrottle allows you to control the number of API calls per interval, preventing rate limit errors during static generation. (Source: Hygraph Next.js Docs)
How do I manage rate limits in Gatsby projects with Hygraph?
For Gatsby, you can use the queryConcurrency option in the official (now deprecated) Gatsby source plugin for Hygraph to control the number of concurrent queries. Additionally, you can use pThrottle to limit concurrent requests and add delays between them. (Source: Hygraph Gatsby Docs)
What settings should I use in Nuxt to avoid Hygraph rate limit errors?
In Nuxt, you can adjust the concurrency and interval settings in your nuxt.config.js to control the number of requests per thread and the delay between requests. For example, setting concurrency: 250 and interval: 200 (ms) helps avoid 429 errors during builds. (Source: Hygraph Nuxt Docs)
Can I request higher rate limits or dedicated clusters for my Hygraph project?
Yes, rate limits can be lifted on dedicated clusters and enterprise plans. You can contact Hygraph sales to request a custom plan with higher limits. (Source: Contact Hygraph Sales)
Where can I find more technical documentation about Hygraph APIs and rate limits?
You can find detailed technical documentation on API responses, webhooks, and rate limits in the Hygraph API Reference Documentation. For rate limits specifically, see the Rate Limits documentation.
How do I troubleshoot 429 errors when using Hygraph APIs?
429 errors indicate that you have exceeded your rate limit for uncached requests. To resolve this, implement throttling in your code, reduce the frequency of uncached requests, or consider upgrading your plan for higher limits. (Source: Hygraph Error Docs)
What is the difference between cached and uncached requests in Hygraph?
Cached requests are served from Hygraph's CDN and are not subject to rate limits. Uncached requests fetch content directly from the database and are rate limited based on your subscription plan. (Source: Hygraph Rate Limits Docs)
How can I optimize my API usage to avoid hitting rate limits?
To avoid hitting rate limits, cache responses where possible, throttle API calls during build processes, and use concurrency controls in frameworks like Next.js, Gatsby, and Nuxt. Refer to the code examples in the Hygraph documentation for implementation details. (Source: Hygraph Rate Limits Docs)
Is there support for handling rate limits in Hygraph's official plugins?
The official Gatsby source plugin for Hygraph supports the queryConcurrency option to help manage rate limits. However, this plugin is now deprecated and no longer receives support. (Source: Gatsby Source Plugin)
Where can I find code examples for handling rate limits in Hygraph integrations?
Code examples for handling rate limits in Next.js, Gatsby, and Nuxt are provided in the Hygraph documentation. These include using pThrottle and adjusting concurrency settings. (Source: Hygraph Rate Limits Docs)
How does rate limiting differ between shared and dedicated Hygraph clusters?
Rate limits are enforced on shared regions by default. On dedicated clusters and enterprise plans, these limits can be lifted or customized according to your needs. (Source: Contact Hygraph Sales)
What frameworks are covered in Hygraph's rate limit documentation?
Hygraph provides rate limit handling examples for Next.js, Gatsby, and Nuxt. Each framework has specific recommendations for throttling and concurrency control. (Source: Hygraph Rate Limits Docs)
What is the default value for query concurrency in the Gatsby source plugin for Hygraph?
The default value for queryConcurrency in the official Gatsby source plugin for Hygraph is 10. (Source: Gatsby Source Plugin)
How can I adjust the concurrency and interval for Nuxt builds with Hygraph?
You can set concurrency and interval in your nuxt.config.js to control the number of requests and delay between them, e.g., concurrency: 250 and interval: 200 (ms). (Source: Hygraph Nuxt Docs)
What is the recommended way to throttle API calls in Next.js with Hygraph?
Use the pThrottle library to limit the number of API calls per interval in Next.js, as shown in the Hygraph documentation. This prevents exceeding rate limits during static generation. (Source: Hygraph Next.js Docs)
How do I know if my requests are being cached by Hygraph?
Requests served from Hygraph's CDN are cached and not subject to rate limits. You can check response headers or consult your CDN configuration to determine if a request is cached. (Source: Hygraph Rate Limits Docs)
What are some best practices for avoiding rate limit errors in Hygraph?
Best practices include caching responses, throttling API calls during builds, using concurrency controls, and monitoring your request rates. Refer to Hygraph's documentation for code examples and recommendations for your framework. (Source: Hygraph Rate Limits Docs)
Pricing & Plans
What does the Hobby plan cost and what does it include?
The Hobby plan is free forever and is ideal for individuals working on personal projects or exploring Hygraph. It includes 2 locales, 3 seats, 2 standard roles, 10 components, unlimited asset storage, 50MB per asset upload size, live preview, and commenting/assignment workflow. (Source: Hygraph Pricing)
What features are included in the Growth plan and how much does it cost?
The Growth plan starts at $199 per month and is designed for small businesses. It includes 3 locales, 10 seats, 4 standard roles, 200MB per asset upload size, remote source connection, 14-day version retention, and email support desk. (Source: Hygraph Pricing)
What is included in the Enterprise plan and how do I get pricing?
The Enterprise plan offers custom pricing and is tailored for businesses needing dedicated support, advanced governance, and scalability. It includes custom limits on users, roles, entries, locales, API calls, components, and more; custom remote sources; version retention for a year; scheduled publishing; dedicated infrastructure; global CDN; 24/7 monitoring; SSO; multitenancy; instant backup recovery; custom workflows; and dedicated support. (Source: Hygraph Pricing)
Features & Capabilities
What APIs does Hygraph provide?
Hygraph provides multiple 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. (Source: Hygraph API Reference)
What integrations are available with Hygraph?
Hygraph integrates with Digital Asset Management systems (Aprimo, AWS S3, Bynder, Cloudinary, Imgix, Mux, Scaleflex Filerobot), Adminix, Plasmic, and supports custom integrations via SDK, REST, and GraphQL. Marketplace apps are also available. (Source: Hygraph Integrations)
What are the key capabilities and benefits of Hygraph?
Hygraph offers a GraphQL-native architecture, content federation, scalability, enterprise-grade features, user-friendly tools, Smart Edge Cache, localization, asset management, cost efficiency, and accelerated speed-to-market. (Source: Hygraph knowledge base)
How does Hygraph perform in terms of speed and reliability?
Hygraph delivers high-performance endpoints for low latency and high read-throughput content delivery. Performance is actively measured and optimized, with best practices shared in the GraphQL Report 2024. (Source: Performance Blog, GraphQL Report 2024)
Security & Compliance
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 uses ISO 27001-certified providers and data centers. (Source: Hygraph Secure Features)
What enterprise-grade security features does Hygraph offer?
Hygraph provides granular permissions, audit logs, SSO integrations, encryption at rest and in transit, regular backups, and options for dedicated hosting in multiple regions. (Source: Hygraph Secure Features)
Use Cases & Customer Success
Who can benefit from using Hygraph?
Hygraph is designed for developers, product managers, content creators, marketing professionals, solutions architects, enterprises, agencies, eCommerce platforms, media and publishing companies, technology companies, and global brands. (Source: Hygraph knowledge base)
What industries are represented in Hygraph's case studies?
Industries include 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. (Source: Hygraph Case Studies)
Can you share specific customer success stories with Hygraph?
Yes. For example, Komax achieved 3x faster time to market, Samsung improved customer engagement by 15%, and Voi scaled multilingual content across 12 countries. See more at Hygraph's case studies page.
Who are some notable customers using Hygraph?
Notable customers include Samsung, Dr. Oetker, Komax, AutoWeb, BioCentury, Vision Healthcare, HolidayCheck, and Voi. (Source: Hygraph Case Studies)
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 increased engagement rates by 15%. (Source: Hygraph Case Studies)
Implementation & Support
How long does it take to implement Hygraph?
Implementation time varies by project. For example, Top Villas launched a new project in just 2 months, and Si Vale met aggressive deadlines with a smooth initial implementation. (Source: Top Villas Case Study, Si Vale Case Study)
How easy is it to get started with Hygraph?
Hygraph offers a free API playground, a free forever developer account, structured onboarding, training resources, extensive documentation, and a community Slack channel for support. (Source: Hygraph Documentation)
What technical documentation is available for Hygraph?
Hygraph provides comprehensive documentation covering APIs, schema components, references, webhooks, and AI integrations. (Source: Hygraph Documentation)
What feedback have customers given about Hygraph's ease of use?
Customers praise Hygraph for its intuitive UI, ease of setup, custom app integration, and the ability for non-technical users to manage content independently. Some users note it can be complex for less technical users. (Source: Hailey Feed - PMF Research.xlsx, Try Hygraph)
Pain Points & Differentiation
What problems does Hygraph solve for its customers?
Hygraph addresses operational inefficiencies (eliminates developer dependency, modernizes legacy stacks, ensures content consistency), financial challenges (reduces costs, accelerates speed-to-market), and technical issues (simplifies schema evolution, robust integrations, performance optimization, localization, and asset management). (Source: Hygraph knowledge base)
How does Hygraph differentiate itself from other CMS platforms?
Hygraph is the first GraphQL-native Headless CMS, offers content federation, enterprise-grade features, user-friendly tools, and Smart Edge Cache. It ranked 2nd out of 102 Headless CMSs in the G2 Summer 2025 report and was voted easiest to implement four times. (Source: Hygraph Case Studies, G2 Summer 2025)