Frequently Asked Questions

Getting Started & Implementation

How do I create a simple FAQ page in Hygraph?

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.

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

#Simple FAQ page

#Overview

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 pageSimple 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:

Mock imageMock image

#Prerequisites

  • REQUIRED: You need to have a Hygraph account. If you don't have one, you can sign up here.
  • REQUIRED: You need to have a Hygraph project. Look into the following section to learn more about your options.

#What you can do

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.

#Not in the mood to start building?

Clone the entire cookbook

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.

#Core concepts

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.

#Step-by-step guide

This video follows the same step-by-step tutorial offered in this document.

#1. Create the FAQ list model

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:

FieldInput
Display nameFAQ List Single
API IDFaqListSingle
API ID PluralFaqListSingles

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:

TabFieldInput
SettingsDisplay nameQuestion
SettingsAPI IDquestion
SettingsDescriptionWrite the question here
SettingsUse as title fieldLeave this checkbox selected
ValidationsMake field requiredSelect this checkbox
ValidationsSet field as uniqueSelect 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:

TabFieldInput
SettingsDisplay nameAnswer
SettingsAPI IDanswer
SettingsDescriptionWrite the answer here
ValidationsMake field requiredSelect this checkbox

Click Add to save.

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.

#3. Create the FAQ page model

To create the FAQ Page model, navigate to the Schema builder and click +Add next to Models. Use the following information:

FieldInput
Display nameSimple FAQ Page
API IDSimpleFaqPage
API ID PluralSimpleFaqPages

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:

TabFieldInput
SettingsDisplay namePage title
SettingsAPI IDpageTitle
SettingsDescriptionWrite a page title here
SettingsUse as title fieldLeave this checkbox selected
ValidationsMake field requiredSelect this checkbox
ValidationsSet field as uniqueSelect 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:

TabFieldInput
DefineAllow only one model to be referencedSelect this radio button.
DefineModel to referenceuse the dropdown to select FAQ List Single
DefineReference directionUse the radio button to select One-way reference
DefineRelation cardinalityOne to Many
DefineAllow multiple (…)Select this checkbox
ConfigureDisplay nameQ&A Pair
ConfigureAPI IDqAPair
ConfigureDescriptionSelect 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.

#Resulting content form

If you followed this tutorial, your resulting content form should look like this:

Resulting content formResulting content form

Editors will be able to easily create FAQ pages by referencing Q&A pairs from the FAQ List model.