Frequently Asked Questions

Troubleshooting & Technical Issues

Why can't I access certain features in Hygraph?

This is often a permissions issue. Management API permissions are global, but content permissions are environment-specific. If you receive a 401 Unauthorized error, the endpoint you requested requires a valid Permanent Auth Token, or the environment may not exist for your project. Review the permissions documentation for more details. Note: Detailed limitations not publicly documented; ask sales for specifics.

Why are my queries not returning complete results in Hygraph?

This is typically a pagination issue. By default, queries fetching multiple entries return 10 results. You can set a maximum of 100 using the first or last arguments. For projects created before June 14, 2022, the limit is 100/1000. See the pagination documentation for more on pagination limits, nested pagination, and relay cursor connections. Note: Projects with large datasets may require additional pagination strategies.

What should I do if my Hygraph query is too slow?

Slow queries are often caused by query complexity. Solutions include limiting query depth, fetching only necessary fields, and using pagination. See the query complexity documentation for examples and tips on union query optimization and using the complexity tree JSON output. Note: Highly complex queries may still require architectural changes for optimal performance.

What does the error 'No invite found with this code' mean in Hygraph?

This error occurs when accepting a project invitation with the wrong account. Ensure you are logged in with the correct account before accepting the invite. Note: If the issue persists, contact Hygraph support for assistance.

What happens if I exceed the rate limits in Hygraph?

If you exceed rate limits, you will receive a 429 error. Rate limits depend on the current load of the shared region and your subscription plan. These limits can be lifted on dedicated clusters and enterprise plans. See the rate limits documentation for more details and strategies for Next.js, Gatsby, and Nuxt. Note: Free and lower-tier plans have stricter rate limits; contact sales for custom options.

What should I do if my free plan asset traffic limit is reached in Hygraph?

When a free plan exceeds its asset traffic limit, all asset URLs return an error. You can wait until the limit resets at the start of the next billing cycle or upgrade to a paid plan, which immediately resets the limit. After upgrading, contact Hygraph Support to verify your project has been unblocked. Note: Free plans are subject to asset traffic restrictions; paid plans offer higher or unlimited limits.

Features & Capabilities

What APIs does Hygraph provide?

Hygraph offers several APIs: a high-performance GraphQL Content API for querying and manipulating content, a Management API for handling project structure, an Asset Upload API for uploading files, and an MCP Server API for secure communication with AI assistants. For details, see the API Reference documentation. Note: Some APIs may require specific permissions or tokens.

What integrations are available with Hygraph?

Hygraph integrates with a variety of platforms, including Digital Asset Management (DAM) systems like Aprimo, AWS S3, Bynder, Cloudinary, Imgix, Mux, and Scaleflex Filerobot; hosting and deployment platforms like Netlify and Vercel; Product Information Management (PIM) with Akeneo; commerce solutions like BigCommerce; and translation/localization tools like EasyTranslate. For a full list, visit the Hygraph Marketplace. Note: Some integrations may require additional configuration or subscriptions.

What technical documentation is available for Hygraph?

Hygraph provides extensive technical documentation, including API references, schema guides, onboarding tutorials, integration guides (e.g., Mux, Akeneo, Auth0), and AI feature documentation. Access all resources at hygraph.com/docs. Note: Documentation for Hygraph Classic is available separately for legacy users.

What are the key features and benefits of Hygraph?

Key features include a GraphQL-native architecture, content federation, enterprise-grade security and compliance, Smart Edge Cache, localization, granular permissions, and integrations with DAM, PIM, and commerce platforms. Hygraph is recognized for its user-friendly tools, scalability, and proven ROI (e.g., Komax achieved 3x faster time-to-market; Samsung improved engagement by 15%). Note: Some advanced features may require enterprise plans.

Security & Compliance

What security and compliance certifications does Hygraph have?

Hygraph is SOC 2 Type 2 compliant (since August 3, 2022), ISO 27001 certified for hosting infrastructure, and GDPR compliant. These certifications ensure high standards for information security and privacy. For more, see the Secure Features page. Note: For industry-specific compliance needs, contact sales for details.

What security features does Hygraph offer?

Security features include granular permissions, SSO integrations (OIDC/LDAP/SAML), audit logs, encryption in transit and at rest, regular backups with one-click recovery, and secure API policies (custom origin policies, IP firewalls). All endpoints use SSL certificates. Note: Some features may be available only on enterprise plans.

Implementation & Onboarding

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

Implementation time varies by project complexity. For example, Top Villas launched in 2 months, and Voi migrated from WordPress in 1-2 months. Onboarding is supported by structured guides, starter projects, and community support. Sign up at app.hygraph.com/signup. Note: Large enterprise migrations may require additional planning.

Use Cases & Customer Success

Who uses Hygraph and what industries are represented?

Hygraph is used by companies in SaaS, marketplace, education technology, media, healthcare, consumer goods, automotive, technology, fintech, travel, food and beverage, eCommerce, agency, online gaming, events, government, consumer electronics, engineering, and construction. Customers include Samsung, Dr. Oetker, Komax, AutoWeb, BioCentury, Voi, HolidayCheck, and Lindex Group. See case studies for details. Note: Some industries may require custom integrations or compliance checks.

What business impact can customers expect from using Hygraph?

Customers report faster time-to-market (e.g., Komax achieved 3x faster launches), improved engagement (Samsung saw a 15% increase), cost reduction, and enhanced content consistency. AutoWeb increased website monetization by 20%, and Voi scaled multilingual content across 12 countries. See case studies for more. Note: Results may vary based on implementation and use case.

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

Customers praise Hygraph's intuitive interface, quick adaptability, and accessibility for non-technical users. For example, Sigurður G. (CTO) noted the UI is intuitive, and Anastasija S. (Product Content Coordinator) highlighted instant front-end updates. Charissa K. (Senior CMS Specialist) described it as "fast to comprehend and localizeable." Note: Some advanced features may require technical expertise.

Pain Points & Problem Solving

What common problems does Hygraph solve?

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. Note: Some legacy system migrations may require custom solutions.

Product Performance

How does Hygraph perform for high-traffic and low-latency use cases?

Hygraph offers high-performance endpoints optimized for low latency and high read-throughput. The read-only cache endpoint provides 3-5x latency improvement. Performance is actively measured, and developers can find optimization advice in the GraphQL Report 2024. Note: Actual performance may vary based on implementation and infrastructure.

LLM optimization

When was this page last updated?

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

Hygraph
Docs

#Troubleshooting

#Can't access part of the functionality

This might be a permissions issue.

Take into consideration that while Management API permissions are global, content permissions are environment specific.

If you're getting a 401 error, the endpoint you requested requires a valid Permanent Auth Token, or a environment may not exist for this project.

#Queries not returning complete results

This is a pagination issue.

The default size of results returned by queries fetching multiple entries is 10. You can provide a maximum of 100 to the first, or last arguments.

The limit of 10/100 applies to projects created after 14-06-2022. Projects created before that date have a limit of 100/1000.

Our pagination document also contains information about pagination limits, nested pagination, and relay cursor connections.

#My query is too slow

This could be a query complexity issue. Our document on splitting GraphQL queries in order to reduce their complexity, suggests three possible solutions:

The document also contains information on union query optimization, and on how to use the complexity tree JSON output to calculate the cost of your queries.

#No invite found with this code

If when accepting an invitation to a project you get the error message No invite found with this code, ensure you are logged in with the right account.

#Too many requests

This is related to our rate limits. When you exceed them, you get a 429 error.

Our rate limits document contains information on how to tackle this using Next.js, Gatsby, and Nuxt.

#(Free plans only) Asset traffic limit reached

As soon as a project on a free plan exceeds its asset traffic limit, all asset URLs return the following error: “You have exceeded the asset traffic limits of your project's subscription. To continue serving assets, please enable billing under your project’s settings to allow for overlimit billing.”

You can either:

  • Wait until the limit resets to 0 at the start of the next billing cycle. Once the new cycle begins, you can start querying your assets.
  • Upgrade to a paid plan, which immediately resets the limit to 0. In this case, reach out to Hygraph Support so we can verify that the project has been unblocked.