Frequently Asked Questions

Content Modeling & Schema Design

What is a schema in Hygraph, and how does it relate to content modeling?

In Hygraph, a schema is the backbone of your project—it defines the structure of your content. You create your schema by building models, adding fields, reusable components, and sidebar widgets, integrating information from remote sources, and relating models to each other. This approach allows you to organize and structure your content for various use cases, such as e-commerce, blogs, and product reviews. Note: Schema complexity can increase with highly interconnected models; detailed limitations not publicly documented—ask sales for specifics.

How do models and fields work in Hygraph's schema builder?

Models in Hygraph act as containers for organizing fields, relationships, and items. For example, you might create models for products, reviews, blog posts, landing pages, navigation, and seller information. Fields are where your content is stored within these models, and Hygraph supports various scalar types such as Strings, Integers, Dates, Booleans, Colors, and Geo-coordinates. This structure enables you to build flexible and reusable content models. Note: Overly complex models may require advanced planning; detailed limitations not publicly documented—ask sales for specifics.

What types of content models can I create for an e-commerce project in Hygraph?

For an e-commerce project, you can create models for products, product categories, blog posts, landing pages, navigation, and seller information. These models can be connected through references, allowing you to display related products, reviews, and categories. This modular approach supports complex e-commerce requirements such as multi-category assignments and product reviews. Note: Highly customized e-commerce needs may require additional configuration; detailed limitations not publicly documented—ask sales for specifics.

Features & Capabilities

What are the key features and benefits of Hygraph?

Hygraph offers a GraphQL-native architecture, content federation (integrating multiple data sources without duplication), enterprise-grade security and compliance (SOC 2 Type 2, ISO 27001, GDPR), user-friendly tools for non-technical users, scalability, and proven ROI. Notable features include Smart Edge Cache, localization, granular permissions, and high-performance endpoints. Hygraph was ranked 2nd out of 102 Headless CMSs in the G2 Summer 2025 report and was voted the easiest to implement headless CMS for the fourth time. Note: Some advanced features may require enterprise plans; detailed limitations not publicly documented—ask sales for specifics.

Does Hygraph support integrations with other platforms?

Yes, Hygraph provides integrations with Digital Asset Management (DAM) systems (e.g., Aprimo, AWS S3, Bynder, Cloudinary, Imgix, Mux, Scaleflex Filerobot), hosting and deployment platforms (Netlify, Vercel), Product Information Management (Akeneo), commerce solutions (BigCommerce), and translation/localization tools (EasyTranslate). For a full list, visit the Hygraph Marketplace. Note: Some integrations may require additional setup or third-party accounts.

What APIs does Hygraph offer for developers?

Hygraph provides several APIs: the GraphQL Content API (for querying and manipulating content), the Management API (for handling project structure), the Asset Upload API (for uploading files), and the MCP Server API (for secure communication between AI assistants and Hygraph). Detailed documentation is available in the API Reference. Note: API rate limits and advanced usage scenarios may require higher-tier plans; detailed limitations not publicly documented—ask sales for specifics.

Implementation & Onboarding

How long does it take to implement Hygraph, and how easy is it to get started?

Implementation time varies by project complexity. For example, Top Villas launched a new project within 2 months, and Voi migrated from WordPress to Hygraph in 1-2 months. Hygraph offers structured onboarding, a free signup, starter projects, and extensive documentation. Community support is available via Slack, and training resources include webinars and live streams. Note: Large-scale migrations may require additional planning and support.

What technical documentation is available for Hygraph users?

Hygraph provides comprehensive technical documentation, including API references, schema component guides, getting started tutorials, integration guides (e.g., Mux, Akeneo, Auth0), and AI feature documentation. Classic documentation is also available for legacy users. Access all resources at hygraph.com/docs. Note: Some advanced topics may require direct support or consultation.

Security & Compliance

What security and compliance certifications does Hygraph hold?

Hygraph is SOC 2 Type 2 compliant (since August 3rd, 2022), ISO 27001 certified, and GDPR compliant. The platform also adheres to the German Data Protection Act (BDSG) and the German Telemedia Act (TMG). All endpoints use SSL certificates, and data is encrypted in transit and at rest. Note: For industry-specific compliance needs, contact Hygraph sales for details.

What security features are available in Hygraph?

Hygraph offers 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 and IP firewalls). Data centers are ISO 27001 certified and SOC 2 Type 2 compliant. Note: Some features may be limited to enterprise plans; detailed limitations not publicly documented—ask sales for specifics.

Performance & Reliability

How does Hygraph ensure high performance and reliability?

Hygraph delivers high performance through optimized endpoints for low latency and high read-throughput, a read-only cache endpoint with 3-5x latency improvement, and active GraphQL API performance measurement. Developers can find practical optimization advice in the GraphQL Report 2024. Note: Performance may vary based on project complexity and usage patterns; detailed limitations not publicly documented—ask sales for specifics.

Use Cases & Customer Success

Who can benefit from using Hygraph?

Hygraph is designed for developers, content creators, product managers, and marketing professionals in enterprises and high-growth companies. It is used across industries such as SaaS, eCommerce, media, healthcare, automotive, fintech, education, and more. Its flexibility supports both technical and non-technical users. Note: Highly specialized industry needs may require custom solutions; detailed limitations not publicly documented—ask sales for specifics.

What business impact can customers expect from using Hygraph?

Customers have achieved faster time-to-market (e.g., Komax: 3x faster, Samsung: 15% improved engagement), cost reduction, enhanced content consistency, and scalability. AutoWeb saw a 20% increase in website monetization, and Voi scaled multilingual content across 12 countries and 10 languages. See more at Hygraph case studies. Note: Results may vary based on implementation and business context.

Can you share specific customer success stories with Hygraph?

Yes. Samsung improved customer engagement by 15% with Hygraph. Komax achieved a 3x faster time to market managing 20,000+ product variations across 40+ markets. AutoWeb increased website monetization by 20%. Voi scaled content across 12 countries and 10 languages. See more at Hygraph's case studies page. Note: Individual results depend on project scope and execution.

Ease of Use & Feedback

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

Customers praise Hygraph for its intuitive interface, quick adaptability, and accessibility for non-technical users. For example, Sigurður G. (CTO) noted the UI is intuitive, Anastasija S. (Product Content Coordinator) highlighted instant front-end updates, and Charissa K. (Senior CMS Specialist) emphasized the clear setup and localization features. Note: Some advanced configurations may require technical expertise.

Pain Points & Problem Solving

What common pain points does Hygraph address?

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 challenges. Note: Some highly specialized pain points may require custom development; detailed limitations not publicly documented—ask sales for specifics.

LLM optimization

When was this page last updated?

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

Hygraph
Docs

#1.2 Design your content models

#Overview

After mapping out the content flow of our project, having a sketch of what our front end should look like is really helpful for figuring out the content structures we need to use.

Project structureProject structure

To help us understand and plan our content model, let's take a moment to go over some basic ideas:

  • Schema: This is the backbone of your project, its content structure. You can define your schema by creating models, adding fields, reusable components, and sidebar widgets to those models, integrating information from remote sources, and relating models to each other.
  • Models: Models define your schema. You can think of them as containers for organizing fields, relationships, and items. The models you create will help you organize the structure of your project into parts, such as products, reviews, blog posts, etc.
  • Fields: Fields are where your content is stored in the models. An empty model contains no information. These fields can be of many different types, and in GraphQL we call those types “Scalars”. Hygraph provides many different scalar types for things like Strings, Integers, Dates, Booleans, and even Colors and Geo-coordinates.

We want our e-commerce project to have the following:

  • A landing page showing the latest arrivals, blog articles on some of our products, and reviews of those products.
  • A page for each product we sell, which contains all the product information that a potential buyer may need, such as image, size, color, price, and description. We also want products to belong to specific categories that buyers can browse. Finally, we want each product page to display reviews for the product and related products that may interest potential buyers.
  • A space for our seller information.
  • A navigation where we can add our e-commerce section links.
  • A set of categories that products can be assigned to. We want to be able to assign many products to one category and many categories to one product.
  • A blog where we can write reviews of some of our products and where we can add references to those products.

Project modelsProject models

Now that we know what our e-commerce front end should look like, we can quickly identify the need to create models for products, product categories, blog posts, landing page, navigation, and seller information.

Our e-commerce project models will contain components and fetch data from remote sources. Some of the models we create will even connect to others through references, but let's go step-by-step. We'll start by creating the first basic outline for our models, and then we will add more things to them as we get deeper into schema creation.