Frequently Asked Questions

Product Overview & Fundamentals

What is Hygraph and how does it work?

Hygraph is the first GraphQL-native, API-first headless CMS that offers Content Federation. It enables organizations to define content structures, empower editorial teams, and deliver content programmatically to any frontend using its GraphQL API. Hygraph is both frontend and backend agnostic, allowing you to create content within Hygraph or source it from other systems. Learn more.

What makes Hygraph different from other headless CMS platforms?

Hygraph stands out by being both frontend and backend agnostic, thanks to its Content Federation capabilities. You can source content from any backend system into Hygraph and deliver it to any frontend using a single GraphQL API. This reduces architectural complexity and eliminates the need for expensive custom middleware. Details here.

How does Hygraph support composability?

Hygraph's Content Federation and extensibility allow you to connect data silos into one API endpoint, future-proofing your tech stack and enabling composable architectures. Read more.

What are the main sections of the Hygraph CMS interface?

The main sections include Overview, Schema Builder, Content Editor, Digital Asset Manager, API Playground, Notifications, Apps, Webhooks, Project Settings, Help, Contact Support, and User Settings. Each section is designed to streamline content management and collaboration. See details.

How do I get started with Hygraph?

You can start by following the Quickstart guide, which covers creating a project, building a schema, adding fields, creating content, publishing, and enabling API access. Extensive documentation and tutorials are available to help you onboard quickly. Quickstart guide.

What is Content Federation in Hygraph?

Content Federation allows you to unify your stack into a single API, reduce architectural complexity, remove redundant data copies, and eliminate custom middleware. You can source content from multiple systems and query it all through one GraphQL API. Learn more.

How does Hygraph enable team collaboration?

Hygraph offers commenting features, role-based permissions, and parallel content editing, allowing editorial and business teams to work together efficiently while administrators maintain governance and security. More info.

What developer tools does Hygraph provide?

Hygraph provides low-code content modeling, rich GraphQL APIs, SDKs, integrations, and tools for CI/CD processes. Developers can define schemas, integrate with preferred frameworks, and deliver high-performance digital products. Developer tools.

How does Hygraph handle performance and scalability?

Hygraph offers industry-leading Graph APIs for content delivery, mutations, and management, supported by a globally distributed infrastructure and advanced caching. This enables ultra-fast, scalable digital products and supports large volumes of globally distributed visitors. Performance details.

What enterprise-grade features does Hygraph offer?

Hygraph provides enterprise-grade security, compliance, certifications (SOC 2 Type 2, GDPR, MACH), granular permissions, support SLAs, and is trusted by thousands of businesses. Enterprise features.

What use cases does Hygraph support?

Hygraph supports programmatic and API-driven content, content-rich applications, content federation, interactive services, and complex schema applications. Examples include media platforms, recipe sites, gaming platforms, self-serve portals, and statistics publications. Use case details.

How can I model content in Hygraph?

You can use the schema builder to create models, add fields, reusable components, sidebar widgets, integrate remote sources, and establish relationships. Hygraph provides guides and best practices for effective content modeling. Content modeling tips.

What resources are available for learning Hygraph?

Hygraph offers extensive documentation, tutorials, guides, code examples, and a public Slack channel for support. Documentation | Slack Channel

How do I migrate to Hygraph from another CMS?

Hygraph provides a migration guide detailing the process of moving from another CMS, including schema design, content import, and API integration. Migration guide.

What is the difference between Hygraph Studio and Classic?

Hygraph Studio is the latest version with enhanced features and UI, while Classic refers to the previous version. Documentation is available for both to support users during transition. Studio vs Classic.

How do I configure webhooks in Hygraph?

You can configure webhooks in the Webhooks section of the CMS. Hygraph provides guides for setting up webhooks to automate workflows and integrate with external systems. Webhook configuration.

How do I localize content in Hygraph?

Hygraph supports content localization by allowing you to add locales to your project and localize fields in your content entries. Guides are available for setting up localization. Localization guide.

What is the API Playground in Hygraph?

The API Playground is a feature where you can test API calls, practice queries and mutations, and explore the capabilities of Hygraph's GraphQL API. API Playground guide.

How do I manage digital assets in Hygraph?

Hygraph provides a Digital Asset Manager tab for uploading and managing assets. You can also integrate with external DAM systems and use asset APIs for advanced workflows. Asset management guide.

How do I connect remote sources in Hygraph?

You can add remote sources to your project to fetch information from external third-party web services. Hygraph provides guides for integrating remote sources and remote fields. Remote source guide.

Features & Capabilities

What are the key capabilities and benefits of Hygraph?

Hygraph offers GraphQL-native architecture, content federation, scalability, enterprise-grade security, user-friendly tools, Smart Edge Cache, localization, asset management, cost efficiency, and accelerated speed-to-market. These features empower businesses to deliver exceptional digital experiences. See case studies.

Does Hygraph provide APIs for integration?

Yes, Hygraph provides multiple APIs: Content API, High Performance Content API, MCP Server API, Asset Upload API, and Management API. These APIs support querying, mutating, asset management, and secure communication with AI assistants. API Reference.

What integrations does Hygraph support?

Hygraph supports integrations with DAM systems (Aprimo, AWS S3, Bynder, Cloudinary, Imgix, Mux, Scaleflex Filerobot), Adminix, Plasmic, custom SDK/API integrations, and marketplace apps for headless commerce and PIMs. Integrations documentation.

What technical documentation is available for Hygraph?

Hygraph offers comprehensive technical documentation covering API reference, schema components, references, webhooks, AI integrations, and more. Documentation.

How does Hygraph ensure high performance?

Hygraph delivers high performance through low-latency, high-throughput endpoints, active performance measurement of its GraphQL APIs, and practical optimization advice for developers. Performance blog.

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

Hygraph is praised for its intuitive UI, ease of setup, custom app integration, and ability for non-technical users to manage content independently. Real-time changes and reduced developer dependency are frequently cited benefits. Try Hygraph.

What security and compliance certifications does Hygraph have?

Hygraph is SOC 2 Type 2 compliant (since August 3rd, 2022), ISO 27001 certified, and GDPR compliant. It offers enterprise-grade security features such as granular permissions, audit logs, SSO, encryption, backups, and dedicated hosting options. Security features.

How does Hygraph handle backups and data recovery?

Hygraph provides regular data backups and instant one-click backup recovery for enterprise customers, ensuring data safety and quick recovery in case of incidents. Backup details.

What is the process for reporting security incidents in Hygraph?

Hygraph provides a customer reporting process for security, confidentiality, integrity, and availability failures, incidents, concerns, and complaints. Security process.

Pricing & Plans

What pricing plans does Hygraph offer?

Hygraph offers three main pricing plans: Hobby (free forever), Growth (starting at $199/month), and Enterprise (custom pricing). Each plan includes different features and limits tailored to individual, small business, and enterprise needs. 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 size, 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 size, remote source connection, 14-day version retention, and email support desk. Get started.

What features are included in the Enterprise plan?

The Enterprise plan offers custom limits on users, roles, entries, locales, API calls, components, remote sources, version retention (1 year), scheduled publishing, dedicated infrastructure, global CDN, 24/7 monitoring, security controls, SSO, multitenancy, backup recovery, custom workflows, dedicated support, and custom SLAs. Try Enterprise.

Use Cases & Benefits

Who can benefit from using Hygraph?

Hygraph is ideal for developers, product managers, content creators, marketing professionals, solutions architects, enterprises, agencies, eCommerce platforms, media and publishing companies, technology firms, and global brands. See case studies.

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, food and beverage, eCommerce, agency, online gaming, events, government, consumer electronics, engineering, and construction. 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 improved customer engagement by 15%. Business impact.

Can you share specific case studies or success stories?

Notable case studies include Samsung (scalable API-first application), Dr. Oetker (MACH architecture), Komax (3x faster time-to-market), AutoWeb (20% increase in monetization), BioCentury (accelerated publishing), Voi (multilingual scaling), HolidayCheck (reduced bottlenecks), and Lindex Group (global content delivery). See all stories.

Who are some of Hygraph's customers?

Customers include Samsung, Dr. Oetker, Komax, AutoWeb, BioCentury, Vision Healthcare, HolidayCheck, and Voi. Customer list.

How long does it take to implement Hygraph?

Implementation time varies by project. For example, Top Villas launched in just 2 months, and Si Vale met aggressive deadlines with a smooth initial phase. Hygraph's onboarding process is designed for efficiency. Top Villas case study.

What onboarding and support resources does Hygraph provide?

Hygraph offers a structured onboarding process, training resources (webinars, live streams, how-to videos), extensive documentation, and a community Slack channel for support. Documentation | Slack Channel

What pain points does Hygraph solve for customers?

Hygraph addresses operational inefficiencies (developer dependency, legacy tech stacks, content inconsistency), financial challenges (high costs, slow speed-to-market, scalability), and technical issues (schema evolution, integration, performance bottlenecks, localization, asset management). Pain points.

How does Hygraph solve these pain points differently than competitors?

Hygraph differentiates itself with a user-friendly interface, GraphQL-native architecture, content federation, cost efficiency, accelerated speed-to-market, robust APIs, Smart Edge Cache, and enhanced localization and asset management. These features set Hygraph apart from traditional CMS platforms. Differentiation.

What are some case studies relevant to each pain point Hygraph solves?

Operational: HolidayCheck (reduced bottlenecks), Dr. Oetker (MACH architecture), Si Vale (intuitive UI). Financial: Komax (faster launches, lower costs), Samsung (global scaling, reduced overhead). Technical: Hygraph case studies highlight simplified development and robust integrations. Case studies.

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

#Learn about Hygraph

Hygraph is the first GraphQL native, API-first, headless CMS that offers Content Federation. It provides all the capabilities of a headless CMS, which makes it frontend agnostic, with the advantage of also being backend agnostic thanks to its unique Content Federation features. This means that you can create content in Hygraph or source it from other systems as well.

As a frontend and backend agnostic API-first solution, Hygraph enables over 50,000 teams around the world to create, enrich, and deliver content programmatically.

#How it works

As a headless content management solution, Hygraph helps organizations define content structures and empower editorial teams to create content within a defined structure.

You can use our schema builder to create the content structure of your project. You can define your schema by creating models and adding fields, reusable components, and sidebar widgets to them, as well as integrating remote sources and establishing relationships with other models.

Once you have set the content structure of your project, teams can use our content editor to create content of their own, or you can use our Content Federation capabilities to source your content from an external system.

Developers can then deliver this content to any frontend of choice and work with their preferred frameworks (React, Next.js, Vue, etc.), using Hygraph's GraphQL API.

Team collaboration is made easy through the use of our Commenting feature, and different roles ensure your project works smoothly across different teams. Editorial and business teams can add content to the CMS in parallel, while administrators can define granular rights and permissions to ensure governance and security.

#Why choose Hygraph?

While most headless web content management solutions are frontend agnostic, Hygraph stands out by being backend agnostic as well, through Content Federation. You can source content from any backend system into Hygraph, then deliver it to any frontend of your choice using our GraphQL API.

You can connect any web service or API to your Hygraph content model to query and join data across multiple sources with a single GraphQL query.

With our Remote Sources feature, you can access remote content & data through the Hygraph GraphQL API, allowing you to create a single content endpoint without having to migrate everything to a single platform.

With Content Federation, you can unify your stack into a single API, reduce the complexity of your architecture, remove redundant copies of your data and get rid of expensive custom middleware code that glues your services together.

Here's why 1000s of businesses, developers and content teams prefer Hygraph to build innovative digital products:

#Composability

Content Federation and extensibility of the platform allows you to connect data silos into one API endpoint and also to future proof your tech stack.

#Developer tools

Hygraph equips your engineering teams with the tools to build what you need, from simple to complex digital products. Developers can define schemas using low-code content modeling capabilities, then use the rich set of GraphQL APIs, SDKs, integrations and tools that we offer to deliver excellent performance in a sustainable way.

We can integrate with your processes (CI/CD), do the heavy lifting at the backend and connect with systems and frameworks of your choice, while you focus on building the best experience for your users.

#Performance

Build ultra-fast scalable digital products such as media, e-learning, digital event platforms, b2b publishing apps, and any other solution leveraging programmatic and API driven content.

We offer industry leading Graph APIs for content delivery, mutations and content management, as well as a globally distributed infrastructure with advanced caching.

With Hygraph, you can boost web performance, rank higher on Google, increase end-user satisfaction, and support large volumes of globally distributed visitors.

#Enterprise ready

Using Hygraph, you will benefit from enterprise-grade security, compliance, certifications and support. Hygraph is recognized by analysts from Gartner and Forrester, trusted by 1000s, certified and secure - SOC 2 Type 2, GDPR, MACH -, and offers the capabilities needed by large-scale enterprises such as granular permissions, support SLA, etc.

#Use cases support

Hygraph enables the following use cases:

  • Programmatic and API driven content: applications where content is not only created by users using the Hygraph UI, but also from other sources by using the API.
  • Content rich applications: platforms with large volumes of rich and detailed content (combination of text, videos, images), usually contributed by large content teams or multiple external stakeholders. Examples include media platforms, recipe sites, gaming platforms, etc.
  • Content Federation: applications that source content from multiple systems (public APIs such as data about weather or internal systems, etc.) and query it all through one GraphQL API.
  • Interactive services: digital products that provide end users with ability to create and submit content; such as self-serve portals, membership platforms, etc.
  • Complex schema: applications hosting content with complex structured information and relationships such as statistics publications, public records publications, etc.

Once you're logged in you'll see a list of all projects you have access to. Clicking on a project will take you to the project directory.

You can navigate between the different sections of the project using the sidebar. These areas are:

Project directoryProject directory

UI SectionWhat you can do
1. OverviewHome screen with a start guide and links to support, documentation and examples.
2. Schema BuilderSetup of the content models as required by your project.
3. Content EditorAccess existing content, create custom content views, create/ edit content, review content, and publish content.
4. Digital Asset ManagerTab to manage and upload your assets.
5. API PlaygroundAn API playground where you can test out API calls.
6. NotificationsA section to manage your notifications.
7. AppsA section to manage apps.
8. WebhooksA section to manage webhooks.
9. Project SettingsDetails about project information, API access, billing, environments, locales and members
10. HelpDocumentation on concepts, code examples, reference apps, features etc.
11. Contact supportHygraph Public Slack Channel
12. User SettingsLogout, User Configuration, Studio/Classic app switch.

#Section contents

This section offers a contents map to help you readily find what you're looking for.

#Fundamentals

DocumentContents
About HygraphContains information about Hygraph, such as how it works, its advantages and use cases. It also offers information on how to navigate the CMS.
Hygraph Studio vs ClassicLearn about the differences between Hygraph Studio & Hygraph Classic.
App walkthroughOne-page app walkthrough showing you the entire app and all of its sections.
QuickstartQuickstart guide containing all basic mechanics involved in creating a project, a model, adding a basic field, creating a content entry, publishing/querying/mutating content, and enabling API access.
Content modelingContains information about the basics of content modeling with Hygraph, and why it is important for all projects.
Content FederationContains information about what Content Federation is and its advantages.
Migrating to HygraphContains information about the process of migrating to Hygraph.
GlossaryContains lists of useful Hygraph related concepts and terms.

#Content modeling

DocumentContents
5 essential questionsLearn the basics of content modeling with Hygraph, and why it is important for all projects.
Structured contentLearn about structured content, what is it and why you should be using it.
Content modeling tipsLearn how to model content effectively by involving your stakeholders and keeping your business goals in mind.
Full process exampleThis example shows the full content modeling process, from research to a finished project schema in Hygraph.
Best practicesLearn about the dos and don'ts of content modeling.

#Getting started

DocumentContents
1.1 Plan your content flowYou'll learn how to plan your content flow before you start building a schema.
1.2 Design your content modelsYou'll learn how to design your content models before you start building a schema.
1.3 Build your content modelsYou'll learn how to build your base content models. You'll add complexity to them as you advance in this tutorial.
2.1 Configure reference fieldsYou'll learn how to configure different types of references and add them to your content models.
2.2 Configure enumerationsYou'll learn how to configure enumerations that we will later use as parts of component fields.
3.1 Build componentsYou'll learn how to build components that you will later add to your models as part of basic and modular component fields.
3.2 Add components to your modelsYou'll learn how to add the components we just created to the models in your schema, using basic and modular component fields.
4.1 Add a Remote SourceYou'll learn how to add a Remote Source to your project in order to fetch information from external third-party web services.
4.2 Remote FieldsYou'll learn how to add Remote Fields to your models.
4.3 Top-level Remote FieldsYou'll learn how to add Top-level Remote Fields to the Query system model.
5.1 Content creationYou'll learn how to create and modify content in the content creator screen and in the Assets system model.
5.2 Content localizationYou'll learn how to add a locale to your project and localize field in your content entries.
5.3 Additional content featuresYou'll learn how to work with content stages, content duplication, and content publishing.
6.1 Exercises: QueriesThis document contains exercises to provide queries practice in our API Playground.
6.2 Exercises: MutationsThis document contains exercises to provide mutations practice in our API Playground.
7.1 Creating a frontend using NextYou will learn how to create your frontend for the getting started project using Next.
7.2 Connecting our storefrontYou will learn how to connect our e-commerce storefront to our existing Hygraph project.
7.3 Preview URLYou will learn how to configure the Preview URL feature. We'll use it to add a Preview button to the sidebar of our content creation screen.
8.1 Configure webhooksYou will learn how to configure a webhook.
Wrap-upThis document contains a recap on our learning objectives, a list of best practices for your Hygraph projects, and some useful links so you can continue learning.

#Resources