Frequently Asked Questions

GraphQL API & Technical Capabilities

What is GraphQL and how does Hygraph utilize it?

GraphQL is an open-source data query and manipulation language for APIs, providing a runtime for fulfilling queries with existing data. Hygraph leverages GraphQL to offer a GraphQL-native API, enabling efficient data management, content federation, and integration with multiple sources. Hygraph provides a GraphQL Playground for schema creation, query testing, and real-time data access. Learn more.

What field types are supported in Hygraph's no-code GraphQL API schema builder?

Hygraph supports a wide range of field types in its schema builder, including String (single-line, multi-line, markdown, slug), Rich Text (raw, html, markdown, text), Integer, Float, Boolean, Date (ISO 8601), DateTime, JSON, Asset (any file type), Color (HEX, RGBA, CSS), Location (latitude, longitude, distance), Enumeration (enums), Reference (simple and union), and Remote fields for external data. See all field types.

How does Hygraph's GraphQL API handle queries and mutations?

Hygraph automatically generates queries for fetching single and multiple entries for each content type. It supports advanced querying features such as filtering, ordering, pagination, localization, content stages, and versioning. The mutations API allows you to create, update, batch update, insert, delete, and upsert entries using GraphQL. Learn more about mutations.

What are the main advantages of using GraphQL with Hygraph?

Key advantages include precise data fetching (no over- or under-fetching), strong schema and type safety, and content federation (combining multiple APIs into a single schema). Hygraph's GraphQL API enables rapid setup, efficient querying, and seamless integration with modern development workflows. See the GraphQL API cheatsheet.

Where can I find Hygraph's GraphQL API cheatsheet and resources?

You can access the GraphQL API cheatsheet directly at this page. Additional resources, including documentation, tutorials, and the Resource Hub, are available at Hygraph Documentation.

Does Hygraph provide technical documentation for developers?

Yes, Hygraph offers comprehensive technical documentation covering API reference, schema field types, queries, mutations, integrations, and more. Visit Hygraph Documentation for details.

Features & Integrations

What features does Hygraph offer?

Hygraph provides a GraphQL-native architecture, content federation, scalability, and a no-code schema builder. Key features include rapid content delivery, flexible localization, digital asset management, personalization, AI integrations, and robust security. For a full list, visit Hygraph Features.

What integrations are available with Hygraph?

Hygraph integrates with platforms such as Netlify, Vercel (hosting/deployment), BigCommerce, commercetools, Shopify (eCommerce), Lokalise, Crowdin, EasyTranslate, Smartling (localization), Aprimo, AWS S3, Bynder, Cloudinary, Mux, Scaleflex Filerobot (digital asset management), Ninetailed (personalization/AB testing), AltText.ai (AI), Adminix, and Plasmic. See all integrations.

Security & Compliance

How does Hygraph ensure security and compliance?

Hygraph is SOC 2 Type 2 compliant, ISO 27001 certified, and GDPR compliant. It offers SSO integrations, audit logs, encryption at rest and in transit, and sandbox environments to protect sensitive data and meet regulatory standards. Learn more about security features.

Pricing & Plans

What is Hygraph's pricing model?

Hygraph offers a free forever Hobby plan, a Growth plan starting at $199/month, and custom Enterprise plans. For details and feature breakdowns, visit the Hygraph Pricing Page.

Use Cases & Customer Success

Who can benefit from using Hygraph?

Hygraph is ideal for developers, IT decision-makers, content creators, project/program managers, agencies, solution partners, and technology partners. It serves modern software companies, enterprises seeking to modernize, and brands aiming to scale globally, improve development velocity, or re-platform from legacy solutions. Learn more about Hygraph's mission.

What industries are represented in Hygraph's case studies?

Hygraph's case studies span industries such as Food and Beverage (Dr. Oetker), Consumer Electronics (Samsung), Automotive (AutoWeb), Healthcare (Vision Healthcare), Travel and Hospitality (HolidayCheck), Media and Publishing, eCommerce, SaaS (Bellhop), Marketplace, Education Technology, and Wellness and Fitness. See all case studies.

Can you share specific customer success stories using Hygraph?

Yes. Komax achieved a 3X faster time to market, Autoweb saw a 20% increase in website monetization, Samsung improved customer engagement with scalable content delivery, and Dr. Oetker enhanced their digital experience using MACH architecture. Explore more success stories.

Who are some of Hygraph's customers?

Notable customers include Sennheiser, HolidayCheck, Ancestry, Samsung, Dr. Oetker, Epic Games, Bandai Namco, Gamescom, Leo Vegas, and Clayton Homes. See customer case studies.

Pain Points & Solutions

What problems does Hygraph solve?

Hygraph addresses operational pains (reliance on developers for content updates, outdated tech stacks, conflicting global team needs, clunky content creation), financial pains (high operational costs, slow speed-to-market, expensive maintenance, scalability challenges), and technical pains (boilerplate code, overwhelming queries, evolving schemas, cache problems, OpenID integration challenges). Learn more about solutions.

How does Hygraph solve pain points for different personas?

For developers: Hygraph reduces boilerplate code and streamlines query management. For content creators/project managers: It offers an intuitive interface for independent content updates. For business stakeholders: Hygraph lowers operational costs, supports scalability, and accelerates speed-to-market. See persona-specific solutions.

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

KPIs include time saved on content updates, number of updates without developer intervention, system uptime, speed of deployment, 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.

Performance & Implementation

How does Hygraph optimize content delivery performance?

Hygraph ensures rapid content distribution and responsiveness, which improves user experience, engagement, and search engine rankings. Optimized delivery reduces bounce rates and increases conversions. Learn more about performance.

How easy is it to get started with Hygraph?

Hygraph is designed for quick onboarding, even for non-technical users. You can sign up for a free account and access documentation, tutorials, and onboarding guides. For example, Top Villas launched a new project in just 2 months. Get started with Hygraph.

What feedback have customers given about Hygraph's ease of use?

Customers praise Hygraph for its intuitive interface and ease of setup. Feedback includes comments like "super easy to set up and use" and "even non-technical users can start using it right away." The UI is described as logical and user-friendly. Read more customer feedback.

Support & Training

What support and training does Hygraph offer?

Hygraph provides 24/7 support via chat, email, and phone. Enterprise customers receive dedicated onboarding and expert guidance. All users have access to documentation, video tutorials, webinars, and a community Slack channel. Contact Hygraph support.

Business Impact & Value

What business impact can customers expect from using Hygraph?

Customers can expect time savings, streamlined workflows, faster speed-to-market, improved customer experience, and operational efficiency. Hygraph helps modernize tech stacks and supports scalable digital experiences. See business impact details.

Getting Started & Resources

How can I get started with Hygraph?

You can sign up for a free-forever account at app.hygraph.com. Resources such as documentation, video tutorials, and onboarding guides are available to help you get started. Access Hygraph Documentation.

Where can I find GraphQL cheatsheets and learning resources?

Hygraph provides a GraphQL Cheatsheet at this page, as well as documentation, Academy, and Resource Hub for developers. Explore developer resources.

Velocity at Scale: Join the Launch of Hygraph’s Latest AI Innovations

GraphQL API cheat sheet

Get started with building your own production ready GraphQL API within minutes using Hygraph. Here’s a cheatsheet to bring you up to speed!

What is GraphQL?

GraphQL is an open-source data query and manipulation language for APIs, and a runtime for fulfilling queries with existing data. Maintained and developed primarily via the GraphQL Foundation, GraphQL has had incredible adoption across a variety of verticals and use cases with organizations like Twitter, Facebook, Expedia, Shopify, and Hygraph to name a few.

Some icons and graphql logo in the center

3 Reasons we love GraphQL

Data Fetching: GraphQL gives you exactly what you ask for. No over or under fetching.

Schema & Type Safety: GraphQL uses a strongly typed system to define the capabilities of an API.

Content Federation: GraphQL can combine multiple APIs into a single schema to make it accessible to the client.

A sample graphql query

No-code GraphQL API schema builder field types in Hygraph

Embrace a low-code API management layer approach to unify your microservices and operations, and focus on growing your business model rather than maintaining it.

String

A string is just a simple string field. Hygraph supports single-line text, multi-line text, markdown and slug, as string variants.

Rich Text

The Rich Text field is an advanced string field that returns your content in raw, html, markdown and text.

Integer

Integers are whole numbers, and are often used to reference price in cents, stock quantities etc.

Float

Floating point numbers represent fractional values with precision, such as distance, weight, volume, etc.

Boolean

Booleans are used for entries that should have a true or false value.

Date

The Date field type adheres to ISO 8601 standard. This means, October 7, 1989 is represented as 1989-10-07.

Date and Time

he DateTime field type also adheres to ISO 8601 standard, allowing you to set specific times on dates.

JSON

Often used for storing large amounts of data, this field could be seen as an “escape hatch” that could lose you some GraphQL benefits.

Asset

Assets are connected to models through a reference field. Assets can be any file type, not just images.

Color

The Color field stores values that can be retrieved in several formats like HEX, RGBA, and CSS color values.

Location

The Location field type returns latitude, longitude, and distance Float values.

Enumeration

Enums are a predefined list of values inside your GraphQL schema, and can be referenced by any content models.

Reference (Simple)

Relations allow you to connect multiple models. In Hygraph they come as one-way or two-way references.

Reference (Union)

GraphQL Union Types (or Polymorphic Relations) allow you to define a list of possible relations, and decide which one to use.

Remote

Remote fields allow you to programmatically bring external data into your graph, without copying them into the CMS.

Working with Hygraph’s GraphQL Query API

Hygraph automatically generates queries for fetching single, and multiple entries for each defined content type belonging to your project.

Fetching Single Entries

The post query is what you would use to fetch a single entry from the CMS.

{
post(where: { id: "..." }) {
id
title
}
}

Fetching Multiple Entries

The posts query is what you would use to fetch multiple entries from the CMS.

{
posts {
id
}
}

Fetching Relations

Imagine posts have a one to many relation with comments. With GraphQL you can query the related comments in the same request.

{
posts {
id
comments {
id
author
}
}
}

Fetching Localizations

When fetching one or more entries, you can also fetch the localized entries. The default locale is set to en.

{
post(where: { id: "..." }, locales: [en, fr, de]) {
title
}
posts(locales: [en, fr, de]) {
title
}
}

Filtering on Stages

When fetching entries, you can also specify the content stage. The default content stage is set to DRAFT.

{
post(where: { id: "..." }, stage: PUBLISHED) {
title
}
posts(stage: PUBLISHED) {
title
}
}

Fetching Versions

You can fetch all data of a specific entry at a point in time using the automatically generated version query.

{
postVersion(where: { id: "abc123", revision: 1, stage: PUBLISHED }) {
id
revision
data
}
}

Combining Arguments

It is also possible to pass multiple arguments at a time. Let’s get the first 3 published posts by time, where the title contains "Hygraph".

{
posts(
where: { title_contains: "Hygraph" }
orderBy: createdAt_DESC
first: 3
stage: PUBLISHED
) {
id
}
}

Combining Queries

Multiple queries can be executed in parallel via a single request to your endpoint. Let's fetch our a single, and multiple posts in one request.

{
post(where: { id: "..." }) {
id
title
}
posts {
id
title
}
}

Directives

We support both the @skip and @include directives for use in your schema.

query ($includeAuthor: Boolean!) {
posts {
id
title
author @include(if: $includeAuthor) {
name
}
}
}

Variables

It's recommended you use GraphQL variables when working with queries that use any variable data values.

query GetPostBySlug($slug: String!) {
post(where: { id: $id }) {
id
title
}
}

Working with the Hygraph’s GraphQL Mutations API

Your project endpoint exposes GraphQL mutations. The mutations API allows you to interact with content ouside of Hygraph using GraphQL.

Create Entries

When creating new content entries, the data argument will have an associated input type that is specific to your content model.

mutation {
createProduct(
data: {
name: "Face Mask",
slug: "face-mask",
price: 1000 }
) {
id
name
slug
price
}
}

Update Entries

When updating single content entry, you must specify the unique where criteria of which you want to update, as well as the new data.

mutation {
updateProduct(
where: { id: "ckgcd5hzc01wd0a446vd3kqrs" }
data: { price: 100 }
) {
id
name
price
}
}

Batch Mutations

Hygraph supports batch mutations that can be applied to "many" entries at once. They comply with Relay connection type specification.

mutation {
updateManyProductsConnection(
where: { featured: true }
data: { featured: false }
) {
edges {
node {
featured
}
}
}
}

Insert Mutations

When inserting related entries, you can connect entries at a given position. The position of entries reflects that fetching relations.

mutation {
updateAuthor(
where: { id: "..." }
data: { posts: { connect: { position: { before: "..." } } } }
) {
id
}
}

Delete Entries

Similar to updating, and upserting entries, you can specify using where the entries you want to delete.

mutation {
deleteProduct(where: { id: "..." }) {
id
name
slug
price
}
}

Upsert Entries

The upsert mutation allows you to create, or update a content entry based on whether the unique where values exist.

mutation {
upsertProduct(
where: { slug: "face-mask" }
upsert: {
create: { name: "Face Mask", slug: "face-mask", price: 1000 }
update: { name: "Face Mask", slug: "face-mask", price: 1000 }
}
) {
id
name
slug
price
}
}

Other Hygraph Content API Capabilities

Get started for free, or request a demo
to discuss larger projects