Content modeling in Hygraph involves building the basic structures for each content model, serving as the backbone for your project. This enables teams to efficiently populate models with content and work independently. Thoughtful content modeling is essential when starting a new project or migrating content to Hygraph. For more details, see the Hygraph blog on content modeling. Note: Content modeling requires initial investment in team education to maximize benefits.
What makes content modeling in Hygraph different from other CMS platforms?
Hygraph offers features such as sortable relations, remote fields, and a high-powered permission system. These enable flexible content structures, integration of external data sources, and granular access control. For example, sortable relations allow content editors to adjust the order of related content without changing the underlying model. Remote fields support content federation, and the permission system ensures only authorized users can make schema or content changes. Note: Some advanced features may require developer involvement for setup. Learn more.
What are sortable relations in Hygraph?
Sortable relations (also known as GraphQL Union Types) allow developers to build flexible models where content editors can change the order of related content directly from the UI. This provides control over how content appears without altering the underlying schema. For implementation details, see the guide on sortable relations. Note: Sortable relations require initial schema setup by developers.
What is the Hygraph Management SDK and how does it help with content modeling?
The Hygraph Management SDK enables teams to create schema migrations using JavaScript and apply changes programmatically. This helps automate schema changes, supports type-safe workflows, and accelerates project setup. Agencies can use the SDK to create reusable schema templates for client projects. For more information, see the Management SDK documentation. Note: The SDK requires familiarity with JavaScript and Hygraph's API.
What are remote fields and how do they support content federation in Hygraph?
Remote fields allow Hygraph to source data from external third-party services and other Hygraph fields via custom resolvers. This enables content federation, where content from multiple sources is integrated into a single GraphQL schema. Changes in external datasets are reflected in Hygraph, supporting use cases like real-time inventory updates for eCommerce. For implementation, see the remote fields documentation. Note: Remote fields require setup and maintenance of external integrations.
What are environments in Hygraph and how are they used?
Environments are isolated instances of a project, allowing teams to make changes to the GraphQL schema and test new content types without affecting production. They are intended for schema experimentation and testing, not for editorial workflows. For more, see the environments documentation. Note: Environments are not designed for live content editing or publishing workflows.
How does Hygraph's permission system support content modeling and team workflows?
Hygraph's permission system allows for customizable roles and granular access controls. Teams can restrict schema access, limit editing or publishing rights, and ensure only authorized users can make changes. This helps prevent accidental schema changes or premature publishing. For more, see the secure features page. Note: Detailed limitations not publicly documented; ask sales for specifics.
Implementation & Onboarding
How long does it take to implement Hygraph for content modeling projects?
Implementation timelines vary 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. Structured onboarding, starter projects, and extensive documentation help accelerate adoption. For more, see Hygraph's Getting Started guide. Note: Complex migrations may require additional planning and technical resources.
What resources are available to help teams get started with content modeling in Hygraph?
Hygraph provides comprehensive documentation, starter projects, webinars, and a public Slack community. Teams can access guides on content modeling, schema setup, and best practices. Developer advocates and customer success teams are available for support. For resources, visit Hygraph Documentation and Hygraph Slack. Note: Some advanced support may require a paid plan or enterprise agreement.
Technical Capabilities & Integrations
What APIs does Hygraph offer for content modeling and management?
Hygraph provides several APIs: the GraphQL Content API for querying and manipulating content, the Management API for project structure, the Asset Upload API for file management, and the MCP Server API for AI assistant integration. For details, see the API Reference documentation. Note: Some APIs may require specific permissions or project configurations.
What integrations are available for content modeling projects in Hygraph?
Hygraph integrates with Digital Asset Management (DAM) systems (e.g., Aprimo, AWS S3, Bynder, Cloudinary, Imgix, Mux, Scaleflex Filerobot), hosting platforms (Netlify, Vercel), PIM (Akeneo), commerce solutions (BigCommerce), and translation/localization tools (EasyTranslate). For a full list, visit the Hygraph Marketplace. Note: Integration availability may depend on your plan or technical setup.
Security, Compliance & Performance
What security and compliance certifications does Hygraph hold?
Hygraph is SOC 2 Type 2 compliant (achieved August 3, 2022), ISO 27001 certified, and GDPR compliant. These certifications ensure high standards for data protection and information security. For more, see the secure features page. Note: For industry-specific compliance needs, contact sales for details.
How does Hygraph ensure high performance for content modeling and delivery?
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 practical optimization advice is available in the GraphQL Report 2024. Note: Actual performance may vary based on project complexity and integration setup.
Use Cases, Benefits & Limitations
Who can benefit from content modeling with Hygraph?
Hygraph is suitable for developers, content creators, product managers, and marketing professionals. It serves enterprises and high-growth companies in industries such as SaaS, eCommerce, media, healthcare, automotive, and more. For industry examples, see Hygraph's case studies. Note: Teams with highly specialized legacy systems may require additional migration planning.
What are the main limitations or edge cases for content modeling in Hygraph?
While Hygraph offers flexible content modeling, advanced features like remote fields and content federation require technical setup and ongoing maintenance. Environments are not intended for editorial workflows. Some limitations are not publicly documented; contact sales for specifics. Note: Teams with highly customized workflows may need to evaluate fit with their requirements.
Customer Success & Recognition
What customer success stories are available for content modeling with Hygraph?
Notable customers include Samsung (15% improved engagement), Komax (3x faster time to market), AutoWeb (20% increase in monetization), and Voi (scaled multilingual content across 12 countries). For more, see Hygraph's case studies. Note: Results may vary by use case and implementation.
What recognition has Hygraph received for its content modeling capabilities?
Hygraph 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. For more, see Hygraph's homepage. Note: Rankings are subject to change in future reports.
Content modeling is the concept of teams building the basic structures for each content model. This structure serves as the backbone for your project enabling teams to be able to easily populate the models with content to fill out the project.
Experimenting with and building content models will be one of the first steps when starting a new project or migrating content to Hygraph. Thoughtfully built content models that consider all variables and stakeholders will be a good runway for your entire content team to work efficiently and independently. We take an in-depth look at what content modeling is and how to approach it from a headless CMS perspective in several of our Hygraph Academy pieces which can be a good start if you need to brush up on the fundamentals.
#What is special about content modeling in Hygraph?
Hygraph has several unique features in the headless CMS space. This is by no means an extensive list of all of the great elements of content modeling but they do highlight some of the features that really set us apart from other headless CMSs.
There are also a lot of exciting things on the roadmap, so consider this a snapshot in time. Our team is working to make Hygraph a highly flexible CMS that gives teams control over exactly how they want to view and use their content. In terms of content modeling, the features that will enable this control are sortable relations, remote fields, and a high-powered permission system.
Sortable Relations
Sortable relations enable greater flexibility for content editors and developers alike. With Hygraph, developers will model the content to build the basic structure of their schema which can manifest itself in a wide range of ways for the project.
They will predefine what elements will be important for that model and the order they should appear in their final form. For clarity and simplicity sake, we’ll say that the content model is going to be a blog post. Typically the structure and order is fixed; however, using sortable relations, content editors are able to adjust the final appearance of the related content.
Developers are able to build a model that has a consistent basic structure and content editors are able to make tailored adjustments without affecting the inherent structure of the model. Practically, this means if editors are working on a blog post and want to change the order of how related content appears on the page or even if the related content should appear on the page it is a simple action. Editors and developers are able to quickly build flexible content using sortable relations giving them unparalleled control.
This content is provided by YouTube. Loading it sets cookies from YouTube.
Management SDK
The management SDK can help teams take a type-safe, programmatic approach to schema changes in their project (if you haven’t had a chance to check it out yet, you can read more about the Management SDK here.) In terms of content modeling specifically, the management SDK can help teams get their projects off the ground quickly. An important step in content modeling is trying out the content models in a real workflow before committing to them with real content.
The Management SDK when combined with the existing content and mutation APIs makes it easy for developers to programmatically add content to the schema, saving the team's time. Agencies can leverage the Management SDK for content modeling by creating schema templates that can easily be applied to the relevant client projects that follow a similar project, making manual schema work largely unnecessary. For more information on how to implement the Management SDK into your project, check out our full documentation the Management SDK.
Remote Fields
Remote fields can be an essential tool to bring content that lives in other services into
Hygraph. We call this concept content federation, where you can easily populate content from existing services into Hygraph, enabling you to have the most current information available in a single GraphQL schema while giving teams the flexibility of a headless CMS. Because the content is being populated from an outside system, when changes occur to this external dataset, they are reflected in Hygraph as well.
Gone are the days of having to manually make changes to a data set when the data is updated. Teams are able to build projects with always up-to-date content and connect existing systems to build out more complex, automated systems, unlocking a broad set of new use cases. For example, when building an eCommerce site, teams are able to use remote fields to populate inventory data so that your site always displays the most current information for inventory.
Environments can be a very useful tool for teams working to refine their content models or experiment with entirely new approaches to modeling. In creating a separate environment from the master environment, developers are able to adjust the GraphQL Schema without affecting the production implementation.
While Environments are intended strictly for schema experimentation (for building editorial workflows, check out Content Stages, it can be very powerful if a project has outgrown its schema or if teams are looking to refine models after they have seen them in production. To implement a new Environment in a project, developers can reference the full Environments documentation here.
High powered permission system
At Hygraph, we make it easy to ensure the right people have access to the right data and can perform only the tasks that they should focus on. As of now, we have customizable roles where teams can ensure that team members who only should access a project’s content, cannot access the schema, and even more granularly, some roles should only be able to edit content but not publish it.
These granular permissions can help teams set up workflows and ensure that teams can only make the changes that they should be able to. Our permission system makes it easier to ensure that your projects grow easily without fear of accidentally publishing something before it has been reviewed or inadvertently changing the schema. (On the off chance something does happen though, make sure that you have Versioning enabled to be able to quickly rollback to a previous version.)
We are diligently working on making our permission system even more powerful so check back often to see how it develops. (Spoiler alert: in the next year, our permissions will become even more granular.)
#How do I get the most out of content modeling with Hygraph?
To get the most out of content modeling using Hygraph, it is important to invest time at the beginning of your project to educate team members on the new approach to content using a headless CMS and how it can benefit them. Taking this time at the beginning of the process will avoid shortcomings later and will help reorient team members on their expectations.
Once the entire team working with the CMS from start to finish on the product has a better understanding of the benefits of working with a headless CMS, it will make it easier to justify the time it takes to learn how to use a new tool properly.
Another critical exercise is to create a mock content modeling exercise (we outline how to do this in this post about basics of content modeling) and work through the entire process of creating content for a POC or trial project.
This project should be a quick exercise where team members discuss how content should be modeled, what their goal for the project is, and then try it out in the CMS. In trying the new workflows in a low stress, low stakes environment, team members who may be familiar with working only with page builders or other CMSs have a chance to understand how the new system works and answer their questions.
While this exercise may seem time consuming, it does wonders for getting the creativity flowing and learning more about how the team’s new workflows will function and what adjustments need to be made. Modular, structured content can unlock a lot of doors for growing teams and established players but it can be a big mental leap if you haven’t had previous exposure to it. Giving team members the preparation they need to make that jump is crucial and will lead to fewer headaches (and a happier team in the long run).
If you have more questions or need some guidance, reach out to our developer advocates on our public slack channel or through our customer success team!
Frequently Asked Questions
Sortable relations (also called GraphQL Union Types) are relations where developers are able to build a highly flexible basic model and content editors have the power to make changes to the presentation without changing the inherent structure. Teams can to change the order of specific relations of a content entry right from the UI enabling even more flexibility to how content will appear in its final form. For more on sortable relations, check out our guide on Working with GraphQL Union Types.
GraphQL Union Types (also known as Sortable Relations) allow for multiple models to be connected using a single relation. Teams can then choose which model to connect on a given content piece and in what order they would like the multiple models to be displayed. For more on GraphQL Union Types, check out our guide on Working with GraphQL Union Types.
Flexible content is content or content models that can be adapted to serve several purposes using high powered features such as GraphQL Union Types to build flexibility into the structure. Flexible content can be content that is easily adapted from the content perspective to make changes or content that has a flexible structure that can be reused in a variety of use cases.
Modular content is content that is structurally broken down into smaller units so that they can be used for a variety of use cases across the project. By using relations to break down content into bite-sized models, teams are able to maintain brand consistency, avoid extra work, and make adjustments to language that will be used across the project within a single content model. To learn more about the benefits of modular content, take a look at our Academy page on Structured Content.
The Hygraph Management SDK which allows teams to create schema migrations using Javascript and apply those changes programmatically. By working with permanent auth tokens that are scoped to individual projects, the Management SDK enables teams to perform schema changes within their project programmatically. To take a deeper dive into the Management SDK, check out this repository.
Remote fields enable data to be sourced from an external third-party web service and other Hygraph Fields as arguments via a custom resolver entry point. Remote fields make it easy to enrich Hygraph projects with external data programmatically. For more information on working with them, check out this post on remote fields.
Content federation is programmatically pulling content from several sources to enrich your Hygraph data. Content federation reduces architecture complexity, removes redundant copies of data, and enriches content programmatically. With content federation, teams are able to leverage their existing services while modernizing their stacks without a large overhaul. For more on content federation, take a look at our content federation blog post.
Environments are isolated instances of a project. Using environments teams can make changes to the GraphQL schema and test out new content types without breaking production implementation. Environments are intended for schema building and testing and should not be used as part of the editorial workflow. For more on Hygraph environments, check out our documentation on environments here.
Either works, but Hygraph strongly recommends modeling "brand identity" (logo, color tokens, fonts, widths) in Hygraph. This empowers editors and avoids developer cycles for rebrands. Many teams regret hard-coding styles when changes become frequent.
Blog Authors
Jing Li
Emily Nielsen
Jonathan Steele
Share with others
Sign up for our newsletter!
Be the first to know about releases and industry news and insights.
Content modeling is the concept of teams building the basic structures for each content model. This structure serves as the backbone for your project enabling teams to be able to easily populate the models with content to fill out the project.
Experimenting with and building content models will be one of the first steps when starting a new project or migrating content to Hygraph. Thoughtfully built content models that consider all variables and stakeholders will be a good runway for your entire content team to work efficiently and independently. We take an in-depth look at what content modeling is and how to approach it from a headless CMS perspective in several of our Hygraph Academy pieces which can be a good start if you need to brush up on the fundamentals.
#What is special about content modeling in Hygraph?
Hygraph has several unique features in the headless CMS space. This is by no means an extensive list of all of the great elements of content modeling but they do highlight some of the features that really set us apart from other headless CMSs.
There are also a lot of exciting things on the roadmap, so consider this a snapshot in time. Our team is working to make Hygraph a highly flexible CMS that gives teams control over exactly how they want to view and use their content. In terms of content modeling, the features that will enable this control are sortable relations, remote fields, and a high-powered permission system.
Sortable Relations
Sortable relations enable greater flexibility for content editors and developers alike. With Hygraph, developers will model the content to build the basic structure of their schema which can manifest itself in a wide range of ways for the project.
They will predefine what elements will be important for that model and the order they should appear in their final form. For clarity and simplicity sake, we’ll say that the content model is going to be a blog post. Typically the structure and order is fixed; however, using sortable relations, content editors are able to adjust the final appearance of the related content.
Developers are able to build a model that has a consistent basic structure and content editors are able to make tailored adjustments without affecting the inherent structure of the model. Practically, this means if editors are working on a blog post and want to change the order of how related content appears on the page or even if the related content should appear on the page it is a simple action. Editors and developers are able to quickly build flexible content using sortable relations giving them unparalleled control.
This content is provided by YouTube. Loading it sets cookies from YouTube.
Management SDK
The management SDK can help teams take a type-safe, programmatic approach to schema changes in their project (if you haven’t had a chance to check it out yet, you can read more about the Management SDK here.) In terms of content modeling specifically, the management SDK can help teams get their projects off the ground quickly. An important step in content modeling is trying out the content models in a real workflow before committing to them with real content.
The Management SDK when combined with the existing content and mutation APIs makes it easy for developers to programmatically add content to the schema, saving the team's time. Agencies can leverage the Management SDK for content modeling by creating schema templates that can easily be applied to the relevant client projects that follow a similar project, making manual schema work largely unnecessary. For more information on how to implement the Management SDK into your project, check out our full documentation the Management SDK.
Remote Fields
Remote fields can be an essential tool to bring content that lives in other services into
Hygraph. We call this concept content federation, where you can easily populate content from existing services into Hygraph, enabling you to have the most current information available in a single GraphQL schema while giving teams the flexibility of a headless CMS. Because the content is being populated from an outside system, when changes occur to this external dataset, they are reflected in Hygraph as well.
Gone are the days of having to manually make changes to a data set when the data is updated. Teams are able to build projects with always up-to-date content and connect existing systems to build out more complex, automated systems, unlocking a broad set of new use cases. For example, when building an eCommerce site, teams are able to use remote fields to populate inventory data so that your site always displays the most current information for inventory.
Environments can be a very useful tool for teams working to refine their content models or experiment with entirely new approaches to modeling. In creating a separate environment from the master environment, developers are able to adjust the GraphQL Schema without affecting the production implementation.
While Environments are intended strictly for schema experimentation (for building editorial workflows, check out Content Stages, it can be very powerful if a project has outgrown its schema or if teams are looking to refine models after they have seen them in production. To implement a new Environment in a project, developers can reference the full Environments documentation here.
High powered permission system
At Hygraph, we make it easy to ensure the right people have access to the right data and can perform only the tasks that they should focus on. As of now, we have customizable roles where teams can ensure that team members who only should access a project’s content, cannot access the schema, and even more granularly, some roles should only be able to edit content but not publish it.
These granular permissions can help teams set up workflows and ensure that teams can only make the changes that they should be able to. Our permission system makes it easier to ensure that your projects grow easily without fear of accidentally publishing something before it has been reviewed or inadvertently changing the schema. (On the off chance something does happen though, make sure that you have Versioning enabled to be able to quickly rollback to a previous version.)
We are diligently working on making our permission system even more powerful so check back often to see how it develops. (Spoiler alert: in the next year, our permissions will become even more granular.)
#How do I get the most out of content modeling with Hygraph?
To get the most out of content modeling using Hygraph, it is important to invest time at the beginning of your project to educate team members on the new approach to content using a headless CMS and how it can benefit them. Taking this time at the beginning of the process will avoid shortcomings later and will help reorient team members on their expectations.
Once the entire team working with the CMS from start to finish on the product has a better understanding of the benefits of working with a headless CMS, it will make it easier to justify the time it takes to learn how to use a new tool properly.
Another critical exercise is to create a mock content modeling exercise (we outline how to do this in this post about basics of content modeling) and work through the entire process of creating content for a POC or trial project.
This project should be a quick exercise where team members discuss how content should be modeled, what their goal for the project is, and then try it out in the CMS. In trying the new workflows in a low stress, low stakes environment, team members who may be familiar with working only with page builders or other CMSs have a chance to understand how the new system works and answer their questions.
While this exercise may seem time consuming, it does wonders for getting the creativity flowing and learning more about how the team’s new workflows will function and what adjustments need to be made. Modular, structured content can unlock a lot of doors for growing teams and established players but it can be a big mental leap if you haven’t had previous exposure to it. Giving team members the preparation they need to make that jump is crucial and will lead to fewer headaches (and a happier team in the long run).
If you have more questions or need some guidance, reach out to our developer advocates on our public slack channel or through our customer success team!
Frequently Asked Questions
Sortable relations (also called GraphQL Union Types) are relations where developers are able to build a highly flexible basic model and content editors have the power to make changes to the presentation without changing the inherent structure. Teams can to change the order of specific relations of a content entry right from the UI enabling even more flexibility to how content will appear in its final form. For more on sortable relations, check out our guide on Working with GraphQL Union Types.
GraphQL Union Types (also known as Sortable Relations) allow for multiple models to be connected using a single relation. Teams can then choose which model to connect on a given content piece and in what order they would like the multiple models to be displayed. For more on GraphQL Union Types, check out our guide on Working with GraphQL Union Types.
Flexible content is content or content models that can be adapted to serve several purposes using high powered features such as GraphQL Union Types to build flexibility into the structure. Flexible content can be content that is easily adapted from the content perspective to make changes or content that has a flexible structure that can be reused in a variety of use cases.
Modular content is content that is structurally broken down into smaller units so that they can be used for a variety of use cases across the project. By using relations to break down content into bite-sized models, teams are able to maintain brand consistency, avoid extra work, and make adjustments to language that will be used across the project within a single content model. To learn more about the benefits of modular content, take a look at our Academy page on Structured Content.
The Hygraph Management SDK which allows teams to create schema migrations using Javascript and apply those changes programmatically. By working with permanent auth tokens that are scoped to individual projects, the Management SDK enables teams to perform schema changes within their project programmatically. To take a deeper dive into the Management SDK, check out this repository.
Remote fields enable data to be sourced from an external third-party web service and other Hygraph Fields as arguments via a custom resolver entry point. Remote fields make it easy to enrich Hygraph projects with external data programmatically. For more information on working with them, check out this post on remote fields.
Content federation is programmatically pulling content from several sources to enrich your Hygraph data. Content federation reduces architecture complexity, removes redundant copies of data, and enriches content programmatically. With content federation, teams are able to leverage their existing services while modernizing their stacks without a large overhaul. For more on content federation, take a look at our content federation blog post.
Environments are isolated instances of a project. Using environments teams can make changes to the GraphQL schema and test out new content types without breaking production implementation. Environments are intended for schema building and testing and should not be used as part of the editorial workflow. For more on Hygraph environments, check out our documentation on environments here.
Either works, but Hygraph strongly recommends modeling "brand identity" (logo, color tokens, fonts, widths) in Hygraph. This empowers editors and avoids developer cycles for rebrands. Many teams regret hard-coding styles when changes become frequent.
Blog Authors
Jing Li
Emily Nielsen
Jonathan Steele
Share with others
Sign up for our newsletter!
Be the first to know about releases and industry news and insights.