Content modeling is the process of breaking down content into organized blocks and demonstrating the relationships between each content type. This helps teams structure their content for flexibility, reusability, and efficient workflows. Content types in a model translate into various field types within a CMS, which then determine how data is presented. Note: Content modeling can require an adjustment period for teams used to page builder approaches. Learn more.
What are the top-down and bottom-up approaches to content modeling?
The top-down approach starts with the final outcome (e.g., a landing page) and builds out the structure by adding fields and related models. It's best for teams with a clear vision of the end product. The bottom-up approach begins with small, reusable pieces of data and connects them to form the final structure, which is ideal for teams with existing datasets or those prioritizing modularity. Both approaches help teams create flexible, reusable content models. Note: Teams may need to iterate and test models with content editors before development begins. Top-down diagram | Bottom-up diagram.
What is structured content?
Structured content is information organized in small, technology-agnostic units with consistent formatting. It often includes metadata and can be reused, analyzed for patterns, and presented flexibly across channels. Note: Overly modular content can become difficult for editors to use; balance is key. Read more.
What is the difference between single-use and reusable content?
Single-use content is created for a specific, one-time purpose (e.g., a blog post or time-sensitive announcement). Reusable content can be published in multiple places or at different times, such as USPs, CTAs, or use cases that remain consistent across projects. Note: Not all content should be made reusable; some is intentionally single-use for clarity or relevance.
How does Hygraph support content modeling best practices?
Hygraph enables both top-down and bottom-up content modeling by allowing users to define subject and specification models, create modular schemas, and connect reusable data. Teams can workshop models using tools like Miro before building them in Hygraph. The platform's GraphQL-native architecture and content federation features further support flexible, scalable content modeling. Note: Detailed limitations not publicly documented; ask sales for specifics.
Features & Capabilities
What features does Hygraph offer for content management?
Hygraph provides a GraphQL-native architecture, content federation, enterprise-grade security and compliance, Smart Edge Cache, localization, granular permissions, and integrations with DAM, PIM, hosting, and commerce platforms. It also offers user-friendly tools for non-technical users and supports modular content modeling. Note: Some advanced features may require higher-tier plans; see documentation for details.
What integrations are available with Hygraph?
Hygraph integrates with platforms such as Aprimo, AWS S3, Bynder, Cloudinary, Imgix, Mux, Scaleflex Filerobot, Netlify, Vercel, Akeneo, Adminix, Plasmic, BigCommerce, and EasyTranslate. For a full list, visit the Hygraph Marketplace. Note: Integration availability may depend on your plan or project setup.
Does Hygraph provide APIs for content management?
Yes, Hygraph offers multiple APIs: a high-performance GraphQL Content API, a Management API (with SDK), an Asset Upload API, and an MCP Server API for AI assistant integration. See the API Reference for details. Note: API usage limits and features may vary by plan.
What technical documentation is available for Hygraph?
Hygraph provides extensive technical documentation, including API references, schema guides, integration tutorials, onboarding guides, and AI feature documentation. Access these resources at hygraph.com/docs. Note: Documentation for legacy (Classic) projects is also available.
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. The platform also adheres to the German Data Protection Act (BDSG) and the German Telemedia Act (TMG). Note: For more details, see the Secure Features page.
What security features are included in Hygraph?
Hygraph includes 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 limited to enterprise plans.
Performance & Implementation
How does Hygraph perform in terms of content delivery and API speed?
Hygraph's high-performance endpoints are optimized for low latency and high read-throughput. The read-only cache endpoint delivers 3-5x latency improvement. Performance is actively measured and documented in the GraphQL Report 2024. Note: Actual performance may vary based on project complexity and integration setup.
How long does it take to implement Hygraph?
Implementation time varies by project. 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. Note: Complex migrations may require additional planning and resources.
How easy is Hygraph to use for non-technical users?
Customers report that Hygraph's interface is intuitive and accessible for both technical and non-technical users. Features like instant front-end updates, clear UI, and granular roles/permissions support efficient workflows. For example, Charissa K. (Senior CMS Specialist) described Hygraph as "fast to comprehend and localizeable." Note: Some advanced configurations may require developer involvement. (Source: Customer reviews, Hailey Feed - PMF Research.xlsx)
Use Cases & Customer Success
Who can benefit from using Hygraph?
Hygraph is suitable for developers, content creators, product managers, and marketing professionals in enterprises and high-growth companies. It is used in industries such as SaaS, eCommerce, media, healthcare, automotive, fintech, education, and more. Note: Teams with highly specialized or legacy requirements may need to evaluate fit with sales.
What business impact can customers expect from using Hygraph?
Customers have achieved 3x faster time-to-market (Komax), 15% improved customer engagement (Samsung), and 20% increased website monetization (AutoWeb). Hygraph also supports scaling multilingual content (Voi: 12 countries, 10 languages) and reducing developer bottlenecks (HolidayCheck). Note: Results depend on implementation and use case. See case studies.
What are some common pain points Hygraph addresses?
Hygraph helps reduce developer dependency, modernize legacy tech stacks, ensure content consistency, streamline workflows, lower operational costs, accelerate speed-to-market, and simplify schema evolution. It also addresses integration difficulties and performance bottlenecks. Note: Some pain points may persist if legacy systems are deeply entrenched or if advanced customization is required.
Can you share specific case studies or customer success stories?
Yes. Notable examples include Samsung (15% improved engagement), Komax (3x faster time-to-market), AutoWeb (20% increase in monetization), Voi (multilingual scaling), and HolidayCheck (reduced developer bottlenecks). See more at hygraph.com/case-studies. Note: Outcomes vary by project scope and execution.
Limitations & Considerations
What are the limitations of using Hygraph for content modeling?
While Hygraph supports flexible content modeling, some advanced use cases or highly specialized workflows may require custom development or consultation with sales. Overly modular content models can become difficult for editors to use, and some features may be limited to higher-tier plans. Detailed limitations are not publicly documented; contact sales for specifics.
This post will help you learn some effective strategies for modeling structured content and give teams a look at how to build a well functioning structured content hub for a variety of project types.
Adapting your content modeling and workflows to work with structured content can sometimes be a daunting task. Teams that begin their work coming from a place of page builder templates must do their best to rethink how and why they want to revamp their content modeling practices. When working with structured content, there are two approaches teams can take to content modeling. The bottom-up approach and the top-down approach. This post will give you a brief guide to go about these approaches and share some best practices on how to implement the content modeling best practices.
The goal of structured content is to strike the balance between building content that is context first, single-use content, and creating content that is too modularized that it becomes difficult for the content team to actually use. Getting into this stride can take some time and adjustments to the content models; however, the payoff of efficient workflows, reusable content, and easy optimization is worth the initial investment. During the content modeling process, it is important to gather input from all of the stakeholders and to test the content models with content editors to ensure that the content models work well for their needs.
If you need some more guidance on the basics of content modeling, check out: What is Content Modeling?
At Hygraph, we use Miro to help us workshop our content models before building them in the CMS. Using Miro we can show the breakdown of models, fields, and the relations between them very easily. For the purposes of this blog post, I have chosen simple content models that will help illustrate how to tackle these two approaches to content modeling. To ensure that we maintain modular thinking when content modeling, we typically use two different types of content models: subject models and specification models. Subject models are used for less reusable data and more often the end product, such as a landing page. Specification models are often reusable content used to enrich the subject model. Specification models can be used for SEO metadata, components that are present on several pages, or Author pages. While there is no visible difference between these two types of models in the CMS, breaking them down for content modeling can be a helpful mental exercise to keep thinking of content as data and to avoid modeling context-dependent content.
The top-down approach can work well for teams who have an idea of what they want the final outcome project and have solidified a final structure. It can be a particularly good approach for teams that are starting a new project and are working through all of the information that they want to be included in the content model.
Start by creating a Subject Model for the end result of your content model, such as a landing page. From here, add in fields that will house the high-level information relevant to this subject model. When adding fields, the most important question to ask yourself is, “Is this the only place this content will live, or will it live in other places in the project as well?” If the answer is, “Yes, it will only live on this subject model.” Then creating a field for the information is likely the best option. However, if the content will live in several places throughout the project, then it will likely function better as a separate model. Creating a separate model ensures the data is reusable and can be connected easily throughout the project.
After you have created the most important fields for the model, add in fields that will serve as relations and begin building out the subject or specification model that is associated with them. With these related models, begin by adding the high-level fields. Return to the initial Subject Model and add in the rest of the fields to describe the rest of the relevant information.
Finally, add in the rest of the descriptive fields to other related fields. Share the content models with all relevant stakeholders and iterate the content models accordingly. This should be done before the development team starts writing code for the frontend because these content models will likely change, slightly after teams work with the data in a practical workflow.
With the Bottom-Up approach, teams start with smaller pieces of modular data rather than the big picture. The goal is to create reusable models that can be used in a variety of contexts and then connect the reusable pieces of data together to build out the desired end product. This is easier for teams who have an existing dataset which they are working to expand or carry over to a new system but can certainly be done with teams creating projects for the first time.
Start with a piece of data, such as a customer, which will be repeated throughout the project and does not have to consider the presentation layer. Keep in mind that the goal of the exercise is to group relevant information into bite-sized models where possible. This will help remove the context of how the content is being presented where possible.
Build out other specification models that will house the related information to the core model. Again the question comes into play, “Is this the only place that the content will live (or could live in the future?” If yes, then it is likely better off as a field in the model. If no, then the content would be more effective as a new model.
Add in the relevant descriptive fields, most importantly the first iteration of references which will connect the various models together to the subject model.
Create a Subject Model that includes the relevant reference fields and the most high-level information.
Add in the descriptive fields to the Subject Model and connect the various models using relations. Show the first iteration of the content models to the rest of the content team to test with content before the development team begins to code and make necessary adjustments.
The Bottom-Up approach follows the modular first mentality of content modeling which can be very effective when trying to shift away from a page builder approach to content modeling. It can be helpful when trying to follow the content hub approach to content management as it forces teams to think modularly first.
Either approach that teams choose will put them on the path to working effectively with structured content. While this approach can take an adjustment period for teams that are used to working with a site builder approach, ultimately they will save teams time and effort by creating a rich repository of content that is reusable and flexible.
What is structured content?
Structured content is information or data that is organized in small units in a technology agnostic and consistent way. It often includes metadata and can be used to determine patterns, similarities, and become an essential element of he final presentation of the data.To learn more about content modeling best practices, check out our Content Modeling Best Practices page.
What is content modeling?
Content modeling is the process of breaking down content into organized blocks and demonstrating the relationships between each content type. Content types can translate into the various field types within a CMS which will translate to the final presentation of the data. To learn more about content modeling best practices, check out our Content Modeling Best Practices page.
What is single-use content?
Single-use content is content that is so specific that it only has one intended purpose. Single-use content could be intentional if it is significant in theme or purpose. These could include blog posts or time-sensitive material.
What is reusable content?
Reusable content is content that can be published in several places or at a different time. These could be things that can be repurposed to meet the needs of several platforms or shorten content creation timelines. Other types of reusable content can be elements of specific digital projects that should remain consistent across the project such as USPs, CTAs or use cases.
Blog Author
Emily Nielsen
Emily manages content and SEO at Hygraph. In her free time, she's a restaurant lover and oat milk skeptic.
Share with others
Sign up for our newsletter!
Be the first to know about releases and industry news and insights.
This post will help you learn some effective strategies for modeling structured content and give teams a look at how to build a well functioning structured content hub for a variety of project types.
Adapting your content modeling and workflows to work with structured content can sometimes be a daunting task. Teams that begin their work coming from a place of page builder templates must do their best to rethink how and why they want to revamp their content modeling practices. When working with structured content, there are two approaches teams can take to content modeling. The bottom-up approach and the top-down approach. This post will give you a brief guide to go about these approaches and share some best practices on how to implement the content modeling best practices.
The goal of structured content is to strike the balance between building content that is context first, single-use content, and creating content that is too modularized that it becomes difficult for the content team to actually use. Getting into this stride can take some time and adjustments to the content models; however, the payoff of efficient workflows, reusable content, and easy optimization is worth the initial investment. During the content modeling process, it is important to gather input from all of the stakeholders and to test the content models with content editors to ensure that the content models work well for their needs.
If you need some more guidance on the basics of content modeling, check out: What is Content Modeling?
At Hygraph, we use Miro to help us workshop our content models before building them in the CMS. Using Miro we can show the breakdown of models, fields, and the relations between them very easily. For the purposes of this blog post, I have chosen simple content models that will help illustrate how to tackle these two approaches to content modeling. To ensure that we maintain modular thinking when content modeling, we typically use two different types of content models: subject models and specification models. Subject models are used for less reusable data and more often the end product, such as a landing page. Specification models are often reusable content used to enrich the subject model. Specification models can be used for SEO metadata, components that are present on several pages, or Author pages. While there is no visible difference between these two types of models in the CMS, breaking them down for content modeling can be a helpful mental exercise to keep thinking of content as data and to avoid modeling context-dependent content.
The top-down approach can work well for teams who have an idea of what they want the final outcome project and have solidified a final structure. It can be a particularly good approach for teams that are starting a new project and are working through all of the information that they want to be included in the content model.
Start by creating a Subject Model for the end result of your content model, such as a landing page. From here, add in fields that will house the high-level information relevant to this subject model. When adding fields, the most important question to ask yourself is, “Is this the only place this content will live, or will it live in other places in the project as well?” If the answer is, “Yes, it will only live on this subject model.” Then creating a field for the information is likely the best option. However, if the content will live in several places throughout the project, then it will likely function better as a separate model. Creating a separate model ensures the data is reusable and can be connected easily throughout the project.
After you have created the most important fields for the model, add in fields that will serve as relations and begin building out the subject or specification model that is associated with them. With these related models, begin by adding the high-level fields. Return to the initial Subject Model and add in the rest of the fields to describe the rest of the relevant information.
Finally, add in the rest of the descriptive fields to other related fields. Share the content models with all relevant stakeholders and iterate the content models accordingly. This should be done before the development team starts writing code for the frontend because these content models will likely change, slightly after teams work with the data in a practical workflow.
With the Bottom-Up approach, teams start with smaller pieces of modular data rather than the big picture. The goal is to create reusable models that can be used in a variety of contexts and then connect the reusable pieces of data together to build out the desired end product. This is easier for teams who have an existing dataset which they are working to expand or carry over to a new system but can certainly be done with teams creating projects for the first time.
Start with a piece of data, such as a customer, which will be repeated throughout the project and does not have to consider the presentation layer. Keep in mind that the goal of the exercise is to group relevant information into bite-sized models where possible. This will help remove the context of how the content is being presented where possible.
Build out other specification models that will house the related information to the core model. Again the question comes into play, “Is this the only place that the content will live (or could live in the future?” If yes, then it is likely better off as a field in the model. If no, then the content would be more effective as a new model.
Add in the relevant descriptive fields, most importantly the first iteration of references which will connect the various models together to the subject model.
Create a Subject Model that includes the relevant reference fields and the most high-level information.
Add in the descriptive fields to the Subject Model and connect the various models using relations. Show the first iteration of the content models to the rest of the content team to test with content before the development team begins to code and make necessary adjustments.
The Bottom-Up approach follows the modular first mentality of content modeling which can be very effective when trying to shift away from a page builder approach to content modeling. It can be helpful when trying to follow the content hub approach to content management as it forces teams to think modularly first.
Either approach that teams choose will put them on the path to working effectively with structured content. While this approach can take an adjustment period for teams that are used to working with a site builder approach, ultimately they will save teams time and effort by creating a rich repository of content that is reusable and flexible.
What is structured content?
Structured content is information or data that is organized in small units in a technology agnostic and consistent way. It often includes metadata and can be used to determine patterns, similarities, and become an essential element of he final presentation of the data.To learn more about content modeling best practices, check out our Content Modeling Best Practices page.
What is content modeling?
Content modeling is the process of breaking down content into organized blocks and demonstrating the relationships between each content type. Content types can translate into the various field types within a CMS which will translate to the final presentation of the data. To learn more about content modeling best practices, check out our Content Modeling Best Practices page.
What is single-use content?
Single-use content is content that is so specific that it only has one intended purpose. Single-use content could be intentional if it is significant in theme or purpose. These could include blog posts or time-sensitive material.
What is reusable content?
Reusable content is content that can be published in several places or at a different time. These could be things that can be repurposed to meet the needs of several platforms or shorten content creation timelines. Other types of reusable content can be elements of specific digital projects that should remain consistent across the project such as USPs, CTAs or use cases.
Blog Author
Emily Nielsen
Emily manages content and SEO at Hygraph. In her free time, she's a restaurant lover and oat milk skeptic.
Share with others
Sign up for our newsletter!
Be the first to know about releases and industry news and insights.