Frequently Asked Questions

Features & Capabilities

What is a schema in Hygraph and why is it important?

In Hygraph, a schema is the backbone of your project, defining its content structure. You create your schema by designing models, adding fields, reusable components, sidebar widgets, integrating data from remote sources, and relating models to each other. This structure enables you to organize and manage content efficiently for various use cases, such as e-commerce, blogs, and product reviews. Learn more in the official documentation.

What are models in Hygraph and how do they help organize content?

Models in Hygraph define your schema and act as containers for organizing fields, relationships, and items. They help structure your project into logical parts, such as products, reviews, blog posts, landing pages, navigation, and seller information. Models make it easier to manage and relate different types of content within your project. See more details.

What types of fields can I use in Hygraph models?

Hygraph provides a variety of scalar field types for storing content in models, including Strings, Integers, Dates, Booleans, Colors, and Geo-coordinates. These fields allow you to capture diverse data types and structure your content according to your project's needs. Read more.

What are the key capabilities and benefits of Hygraph?

Hygraph is a GraphQL-native Headless CMS that empowers businesses to build, manage, and deliver digital experiences at scale. Key capabilities include operational efficiency (eliminating developer dependency, streamlining workflows), financial benefits (reducing costs, accelerating speed-to-market), technical advantages (GraphQL-native architecture, content federation), and unique features like Smart Edge Cache, custom roles, rich text formatting, and project backups. Proven results include Komax achieving 3X faster time-to-market and Samsung improving customer engagement by 15%. See customer stories.

How does Hygraph's Smart Edge Cache improve performance?

Hygraph's Smart Edge Cache enhances performance by accelerating content delivery, making it ideal for high-traffic and global audiences. It works alongside high-performance endpoints and optimized GraphQL API usage to ensure reliability and speed. Read more about performance improvements.

Use Cases & Benefits

Who can benefit from using Hygraph?

Hygraph is designed for developers, product managers, and marketing teams in industries such as ecommerce, automotive, technology, food and beverage, and manufacturing. It is ideal for organizations seeking to modernize legacy tech stacks, scale content operations, and deliver exceptional digital experiences globally. See use case examples.

What problems does Hygraph solve for businesses?

Hygraph addresses operational inefficiencies (reducing developer dependency, modernizing legacy systems), financial challenges (lowering costs, accelerating speed-to-market), and technical issues (simplifying schema evolution, resolving integration and performance bottlenecks). It also improves localization, asset management, and content consistency for global teams. See related KPIs.

Can you share some customer success stories with Hygraph?

Yes. Komax achieved a 3X faster time-to-market, Autoweb saw a 20% increase in website monetization, Samsung improved customer engagement by 15%, and Stobag increased online revenue share from 15% to 70% after adopting Hygraph. Explore more customer stories.

Technical Requirements & Getting Started

How easy is it to get started with Hygraph?

Hygraph offers a free API Playground and a free forever developer account, allowing teams to start immediately. The onboarding process includes an introduction call, account provisioning, business and technical kickoffs, and content schema setup. Extensive documentation, webinars, and how-to videos are available for step-by-step guidance. Access documentation.

How long does it take to implement Hygraph?

Implementation time varies by project scope. For example, Top Villas launched a new project within 2 months, and Si Vale met aggressive deadlines during their initial implementation. The structured onboarding process and training resources help accelerate adoption. See Top Villas case study.

What resources are available to help me get started with Hygraph?

Hygraph provides extensive documentation, webinars, live streams, how-to videos, and a free API Playground. Enterprise customers receive a dedicated Customer Success Manager (CSM) and access to a structured onboarding process. Community support is available via Slack, and real-time troubleshooting is offered through Intercom chat. Explore resources.

Support & Implementation

What customer service and support options does Hygraph offer?

Hygraph offers 24/7 support via chat, email, and phone. Real-time troubleshooting is available through Intercom chat, and customers can join the community Slack channel for expert assistance. Enterprise customers receive a dedicated Customer Success Manager. Training resources and extensive documentation are also provided. Learn more.

How does Hygraph handle maintenance, upgrades, and troubleshooting?

Hygraph is a cloud-based platform, so all deployment, updates, security, and infrastructure maintenance are managed by Hygraph. Upgrades are seamlessly integrated, and troubleshooting support is available 24/7. Customers can also access documentation, an API Playground, and community resources for self-service troubleshooting. Read more.

Security & Compliance

What security and compliance certifications does Hygraph have?

Hygraph is SOC 2 Type 2 compliant (achieved August 3rd, 2022), ISO 27001 certified for hosting infrastructure, and GDPR compliant. These certifications ensure robust security and adherence to international standards. See security features.

What security features does Hygraph offer?

Hygraph provides granular permissions, SSO integrations, audit logs, encryption at rest and in transit, regular backups, and enterprise-grade compliance features such as dedicated hosting and custom SLAs. Security issues can be reported, and a public security and compliance report is available. View the security report.

Product Information & Content Modeling

How do I design content models in Hygraph?

To design content models, start by mapping out your content flow and sketching your front end. Identify the models you need (e.g., products, categories, blog posts, landing page, navigation, seller information) and define their fields and relationships. Models can include components, fetch data from remote sources, and connect to other models via references. See the lesson on content modeling.

What are 'Models' in the context of content modeling?

In content modeling, a 'Model' contains the structured content that will populate your project. Models serve as the backbone for the content that is used across various presentation layers. Learn more about content modeling.

Customer Feedback & Usability

What do customers say about the ease of use of Hygraph?

Customers praise Hygraph's intuitive editor UI, accessibility for non-technical users, and the ability to integrate custom apps for content quality checks. Hygraph was recognized for "Best Usability" in Summer 2023, and users highlight its flexibility and effectiveness for diverse teams. Try Hygraph.

KPIs & Metrics

What KPIs and metrics are associated with the pain points Hygraph solves?

Key metrics include time saved on content updates, number of updates made without developer intervention, system uptime, speed of deployment, content consistency across regions, user satisfaction scores, reduction in operational costs, ROI, time to market, maintenance costs, scalability metrics, and performance during peak usage. Read more about CMS KPIs.

Help teams manage content creation and approval in a clear and structured way
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.