To create a simple FAQ page in Hygraph, you need to set up two models: one for storing Q&A pairs (FAQ List Single) and another for the FAQ page itself (Simple FAQ Page). The FAQ List Single model lets you create individual question and answer entries, while the Simple FAQ Page model allows you to reference these Q&A pairs to assemble your FAQ page. For a step-by-step guide, visit the official documentation or watch the tutorial video.
What are the prerequisites for building a FAQ page in Hygraph?
You need a Hygraph account and an active project. If you don't have an account, you can sign up here. You can either create a new project for learning purposes or use an existing project to add the FAQ models. Make sure to consider plan limits when adding new models or recipes.
How long does it take to implement Hygraph for a new project?
Implementation time varies by project scope. For example, Top Villas launched a new project within 2 months from initial contact, and Si Vale met aggressive deadlines during their initial implementation. Hygraph's structured onboarding and free API playground allow teams to start immediately. Read the Top Villas case study for more details.
How easy is it to get started with Hygraph?
Hygraph is designed for easy onboarding. You can start immediately with the free API playground and a free forever developer account. The platform offers a structured onboarding process, including introduction calls, account provisioning, and technical/content kickoffs. Extensive documentation and training resources (webinars, live streams, how-to videos) are available at Hygraph Documentation.
Features & Capabilities
What are the key features of Hygraph?
Hygraph offers a GraphQL-native Headless CMS with features such as Smart Edge Cache for fast content delivery, content federation for integrating multiple data sources, granular permissions, SSO integrations, audit logs, encryption, regular backups, and rich text formatting. It supports operational efficiency, scalability, and enterprise-grade security. Learn more about Hygraph's features.
Does Hygraph support content reuse and modular FAQ lists?
Yes, Hygraph allows you to create Q&A pairs as individual content entries in a model. These entries can be referenced in other models or components, enabling modular content reuse. This approach is ideal for assembling FAQ lists or blocks across different pages. Read more about the reference FAQ component approach.
How does Hygraph ensure high product performance?
Hygraph delivers exceptional performance through Smart Edge Cache for faster content delivery, high-performance endpoints, and optimized GraphQL API usage. These features are designed for reliability and speed, especially for high-traffic and global audiences. For technical details, see the performance improvements blog post.
What security and compliance certifications does Hygraph have?
Hygraph is SOC 2 Type 2 compliant (since August 3, 2022), ISO 27001 certified for hosting infrastructure, and GDPR compliant. It also supports CCPA compliance and provides enterprise-grade security features such as granular permissions, SSO, audit logs, encryption, and regular backups. For more details, see the security features page and security report.
Use Cases & Benefits
Who can benefit from using Hygraph?
Hygraph is ideal for developers, product managers, and marketing teams in industries such as ecommerce, automotive, technology, food and beverage, and manufacturing. It is especially suited for organizations modernizing legacy tech stacks, global enterprises needing localization and asset management, and businesses aiming to deliver exceptional digital experiences. See customer stories.
What problems does Hygraph solve?
Hygraph addresses operational inefficiencies (reducing developer dependency, modernizing legacy tech stacks, improving content consistency), financial challenges (lowering operational costs, accelerating speed-to-market, supporting scalability), and technical issues (simplifying schema evolution, resolving integration difficulties, optimizing performance, and enhancing localization and asset management). See related KPIs.
What are some customer success stories with Hygraph?
Komax achieved a 3X faster time-to-market managing over 20,000 product variations across 40+ markets. Autoweb saw a 20% increase in website monetization. Samsung improved customer engagement by 15% with a scalable member platform. Stobag increased online revenue share from 15% to 70% after transitioning to a digital-first approach. Explore more customer stories.
Support & Training
What support and training resources are available for Hygraph customers?
Hygraph provides 24/7 support via chat, email, and phone, real-time troubleshooting through Intercom chat, a community Slack channel (join here), extensive documentation (Hygraph Documentation), webinars, live streams, and how-to videos. Enterprise customers receive a dedicated Customer Success Manager and a structured onboarding process.
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 is supported via 24/7 support, Intercom chat, community Slack, and extensive documentation. Enterprise customers have access to a dedicated Customer Success Manager for personalized guidance.
Product Information & Technical Details
Why should I create the FAQ list as a model instead of another structure?
Creating the FAQ list as a model allows you to create Q&A sets as individual content entries, which can be easily referenced in other models or components. This modular approach enables content reuse and lets editors quickly assemble FAQ landing pages from existing topic-based FAQ sections. Learn more about sectioned FAQ pages.
What is the reference FAQ component approach and what are its benefits?
The reference FAQ component recipe lets you manage Q&A pairs as individual content pieces, making them easy to update and reuse across your website. This approach is ideal for displaying different sets of Q&A pairs in various models or components. Read more about the reference FAQ component.
Security & Compliance
How does Hygraph ensure data security and compliance?
Hygraph provides enterprise-grade security with SOC 2 Type 2 and ISO 27001 certifications, GDPR and CCPA compliance, granular permissions, SSO integrations, audit logs, encryption at rest and in transit, and regular backups. Customers can review the security and compliance report for certified infrastructure.
Customer Experience & Usability
How do customers rate the ease of use of Hygraph?
Customers consistently praise Hygraph's intuitive editor UI, describing it as easy to set up and use—even for non-technical users. Hygraph was recognized for "Best Usability" in Summer 2023. Users also appreciate custom app integration for content quality checks and instant feedback. Try Hygraph to experience its usability.
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.
This guide shows how to create an FAQ model that lets you add pre-created Q&A pairs to form a list.
You'll create two models: one model to store the Q&A pairs, and a model that will let you add Q&A pairs through reference fields to form a list.
Simple FAQ page
This recipe is a great option if you prefer to work on Q&A pairs as individual content pieces that you can easily add to another model to create the FAQ list.
This mock image shows what a frontend using this setup could look like:
Use this guide to create a Simple FAQ Page model. You have two options:
OPTION 1:Create a project. This is the way to go if you want to follow the entire tutorial for learning purposes.
OPTION 2:Use an existing project of yours. This is the way to go if you already have a project and want to add this model. In this case, you may need to adjust parts of the tutorial to your own project schema.
Take plan limits into consideration when
adding a recipe to your own project. - Are you new to Hygraph? You may want to
check out our Getting Started
Tutorial!
This is the way to go if you're curious about how we built the FAQ recipes but don't want to follow the step-by-step creation process. This project contains the entire FAQ Cookbook so you can compare recipes or look into what instances they contain.
In this guide, you'll work with different schema elements to create a Simple FAQ Page model. Let's look into them:
Model: Your schema is the content structure of your project. You can define your schema by creating models, adding fields, reusable components, and sidebar widgets, integrating remote sources, and establishing relationships with other models.
References: References are relations between two or more content entries in your project. With references, you can reuse content entries by connecting them. Once the relation is configured, you can also create related content directly from the content form.
This model will let you create Q&A pairs as content entries.
To create the model, navigate to the Schema builder and click +Add next to Models. Use the following information:
Field
Input
Display name
FAQ List Single
API ID
FaqListSingle
API ID Plural
FaqListSingles
Click Add Model to save.
Now that the model has been created, you can start adding fields to it.
We will add a Single line text field to use as question, and a Rich Text field for the answer.
Let's start with the question. Add a Single line text field from the right sidebar, and use the following information:
Tab
Field
Input
Settings
Display name
Question
Settings
API ID
question
Settings
Description
Write the question here
Settings
Use as title field
Leave this checkbox selected
Validations
Make field required
Select this checkbox
Validations
Set field as unique
Select this checkbox
Click Add to save.
Next, you want include a rich text field for the answer, which will also allow some formatting. Add a Rich text field from the right sidebar, using the following information:
Tab
Field
Input
Settings
Display name
Answer
Settings
API ID
answer
Settings
Description
Write the answer here
Validations
Make field required
Select this checkbox
Click Add to save.
In this case, we're not enabling embedding because we don't need to insert content from other Q&A pairs or even from other models in our simple setup. Consider enabling embedding if your content can benefit from it.
We chose to create the FAQ list as a model because in a use case like this, we want to create question & answer sets as content entries that can be easily referenced in other models later on. In the next step, we will create the Simple FAQ Page Model with a reference field that connects this model, which will allow editors to quickly set up FAQ landing pages using existing data.
To create the FAQ Page model, navigate to the Schema builder and click +Add next to Models. Use the following information:
Field
Input
Display name
Simple FAQ Page
API ID
SimpleFaqPage
API ID Plural
SimpleFaqPages
Click Add Model to save.
This model will contain only two fields: a Single line text field for the page title, and a Reference field to add Q&A pairs from the model you created in the previous step.
Let's start with the title. Add a Single line text field from the right sidebar, and use the following information:
Tab
Field
Input
Settings
Display name
Page title
Settings
API ID
pageTitle
Settings
Description
Write a page title here
Settings
Use as title field
Leave this checkbox selected
Validations
Make field required
Select this checkbox
Validations
Set field as unique
Select this checkbox
Click Add to save.
This configuration ensures that all FAQ Page entries contain a unique title that will allow easy identification in the content form.
Next, you will create a reference field that will allow editors to add content entries from the model you created in the previous step.
Add a Reference field from the right sidebar, using the following information:
Tab
Field
Input
Define
Allow only one model to be referenced
Select this radio button.
Define
Model to reference
use the dropdown to select FAQ List Single
Define
Reference direction
Use the radio button to select One-way reference
Define
Relation cardinality
One to Many
Define
Allow multiple (…)
Select this checkbox
Configure
Display name
Q&A Pair
Configure
API ID
qAPair
Configure
Description
Select Q&A pairs
Click Add to save.
Your model is ready! This is how you build a Simple FAQ Page model that lets you easily add Q&A pairs through a reference field.
Pro Tip
You could also add the same set of fields to a component rather than a model to reuse as a template for an FAQ list block. We explore this idea in our Reference FAQ Component recipe.