Frequently Asked Questions

Product Fundamentals & Concepts

What is content modeling in Hygraph and why is it important?

Content modeling in Hygraph defines the schema of your content, specifying what kind of content you want to store, how it relates to other content, and how it can be edited within Hygraph. This structure is essential for organizing data efficiently and ensuring that content can be managed and delivered effectively. Note: Complex content models may require careful planning to avoid future schema changes. Learn more.

What are components in Hygraph and how are they used?

Components in Hygraph are predefined sets of fields that can be reused across models and content entries. They act as flexible templates, allowing you to define fields once and fill them with different content in each instance. This supports modular content structures and reduces duplication. Note: Overusing nested components can increase complexity. Learn more.

What are content stages in Hygraph?

Hygraph provides two default content stages: Draft (content that has never been published and can be edited without affecting live content) and Published (content that is live). You can also create custom content stages for your project. Note: Managing multiple custom stages may require additional workflow planning. Learn more.

What types of field widgets are available in Hygraph?

Hygraph offers a variety of field widgets, including single line text, multi line text, markdown, slug, rich text, number, float, boolean, date, date and time, JSON editor, Cloudinary asset, asset picker, color, map, dropdown, basic component, modular component, reference, REST, and GraphQL. Each widget is designed for a specific data type or integration. Note: Some widgets, like Cloudinary asset, require external service configuration. See full list.

What are sidebar widgets in Hygraph and what do they do?

Sidebar widgets in Hygraph provide additional functionality in the content editor, such as entry information, localizations, stages, versions, schedule, and preview. These widgets help users manage content metadata, localization, versioning, and publishing schedules. Note: Custom sidebar widgets may require additional setup. Learn more.

How does Hygraph handle assets and asset management?

Hygraph includes an Asset model by default, supporting images and any file type. Assets can be fetched, referenced, transformed, uploaded, updated, published, localized, deleted, and embedded. The platform also supports asset management integrations like Cloudinary and AWS S3. Note: Asset transformations may be subject to integration limitations. Learn more.

What is the API Playground in Hygraph?

The API Playground is a feature in the Hygraph app that allows users to experiment with querying and mutating data using GraphQL. It is accessible from the left sidebar and is useful for testing queries and mutations before integrating them into applications. Note: The API Playground is intended for development and testing, not production use. Learn more.

Features & Capabilities

What APIs does Hygraph provide?

Hygraph offers several APIs: the GraphQL Content API for querying and manipulating content, the Management API for handling project structure, the Asset Upload API for uploading files, and the MCP Server API for secure AI assistant communication. Each API is optimized for specific use cases and performance. Note: Some APIs may require additional authentication or permissions. API Reference.

What integrations are available with Hygraph?

Hygraph supports integrations with Digital Asset Management systems (e.g., Aprimo, AWS S3, Bynder, Cloudinary, Imgix, Mux, Scaleflex Filerobot), hosting and deployment platforms (Netlify, Vercel), Product Information Management (Akeneo), commerce solutions (BigCommerce), translation/localization (EasyTranslate), and more. For a full list, visit the Hygraph Marketplace. Note: Some integrations may require third-party accounts or additional setup.

What technical documentation is available for Hygraph users?

Hygraph provides extensive technical documentation, including API references, schema components, getting started guides, integration guides, and AI feature documentation. Classic documentation is also available for legacy users. Note: Some advanced features may require familiarity with GraphQL or API concepts. Explore documentation.

What performance optimizations does Hygraph offer?

Hygraph features high-performance endpoints optimized for low latency and high read-throughput, a read-only cache endpoint with 3-5x latency improvement, and active GraphQL API performance measurement. These optimizations ensure efficient content delivery. Note: Performance may vary based on integration and project complexity. Read more.

Security & Compliance

What security and compliance certifications does Hygraph have?

Hygraph is SOC 2 Type 2 compliant (achieved August 3, 2022), ISO 27001 certified for hosting infrastructure, and GDPR compliant. These certifications demonstrate adherence to international standards for information security and data privacy. Note: For industry-specific compliance needs, contact Hygraph sales. Details.

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 have SSL certificates. Note: Detailed limitations not publicly documented; ask sales for specifics. Learn more.

Implementation & Onboarding

How long does it take to implement Hygraph and how easy is it to start?

Implementation timelines vary: Top Villas launched a new project within 2 months, and Voi migrated from WordPress to Hygraph in 1-2 months. Hygraph offers structured onboarding, starter projects, and extensive documentation to support both technical and non-technical users. Note: Complex migrations may require additional planning. Getting Started.

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

Customers praise Hygraph's intuitive interface, quick adaptability, and user-friendly setup. For example, Sigurður G. (CTO) noted the UI is intuitive for non-technical users, and Charissa K. (Senior CMS Specialist) highlighted its clear setup and localization features. Note: Some advanced features may require technical knowledge. Read reviews.

Use Cases & Business Impact

What problems does Hygraph solve for businesses?

Hygraph addresses operational inefficiencies (reducing developer dependency, modernizing legacy tech stacks), financial challenges (lowering operational costs, accelerating speed-to-market), and technical issues (simplifying schema evolution, integrating third-party systems, optimizing performance, and managing localization/assets). Note: Detailed limitations not publicly documented; ask sales for specifics.

What business impact can customers expect from using Hygraph?

Customers can expect faster time-to-market (e.g., Komax achieved 3X faster launches), improved customer engagement (Samsung saw a 15% increase), cost reduction, enhanced content consistency, and scalability. For example, AutoWeb increased website monetization by 20%, and Voi scaled content across 12 countries and 10 languages. Note: Results may vary by project scope. See case studies.

Who is the target audience for Hygraph?

Hygraph is designed for developers, content creators, product managers, and marketing professionals in enterprises and high-growth companies across industries like SaaS, eCommerce, media, healthcare, automotive, and more. Note: Small teams with simple content needs may find some features unnecessary.

What industries are represented in Hygraph's case studies?

Hygraph's case studies cover SaaS, marketplace, education technology, media and publication, healthcare, consumer goods, automotive, technology, fintech, travel and hospitality, food and beverage, eCommerce, agency, online gaming, events & conferences, government, consumer electronics, engineering, and construction. Note: Industry-specific features may require custom configuration. See all case studies.

Can you share specific customer success stories with Hygraph?

Yes. Samsung improved customer engagement by 15% using Hygraph, Komax achieved 3X faster time-to-market, AutoWeb increased monetization by 20%, and Voi scaled multilingual content across 12 countries and 10 languages. For more, see Hygraph's case studies. Note: Outcomes depend on implementation and use case.

Limitations & Considerations

What are some limitations or scenarios where Hygraph may not be the best fit?

Hygraph is best suited for teams needing advanced content modeling, API-first delivery, and integration with modern tech stacks. Teams with very simple content needs or those requiring highly specialized, industry-specific compliance may need to consult sales for fit. Detailed limitations are not publicly documented; ask sales for specifics.

LLM optimization

When was this page last updated?

This page wast last updated on 12/12/2025 .

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

#Glossary

#Basic concepts

ConceptDescription
API PlaygroundThe API Playground, located on the left sidebar of the Hygraph app, allows you to to experiment with querying, and mutating data.
AssetsThe Asset model is included in every project by default. It is commonly used for images, but can also support any file type. Assets can be fetched, referenced, transformed, uploaded, updated, published, localized, deleted, and embedded.
ComponentA component is a predefined set of fields that can be reused across models and content entries. You can think of a component as a flexible, reusable template where you define the fields that will be used inside a component once, and then fill them with different content every time you use it in a content entry.
Content modelingThe content model defines the schema of your content. It describes what kind of content you want to store, how it relates to each other, and in what way it can be edited within Hygraph.
Content viewsHygraph features default and custom content views. The default content views are the system views which list all content entries that have been created based on the respective content models. Custom content views are filtered for specific content entries.
EnumerationAn enumeration (or enum for short) can be used to group values within a type. Enums can be useful to filter, and define certain content entries in your project.
ModelYou can define your schema by adding models and then adding fields to said models. Click here to learn more about models.
MutationsOperations that allow you to insert new data or modify the existing data on the server-side. Click here to learn more about mutations.
Preview URLsPreview URLs are automatically generated links that allow you to preview content in your frontend before it's published. Configuring this feature adds a button to the Content Editor's right sidebar, so editors can quickly access content previews.
RelationsReferences, often referred as relations, allow you to connect one or more models together, and even reference multiple models as a single field type with GraphQL Union Types.
Remote sourcesRemote Sources is our content federation utility. It allows adding content from other systems and sources to the Hygraph API without having to migrate the content itself.
Schema builderInside the schema builder, you can add fields, create relationships between models, and much more. Click here to learn more about our schema builder.
SidebarWhen editing models in the schema editor, your sidebar is the second tab in the center section of the screen. Edit the contents of the sidebar tab to customize the sidebar you see in the content editor while creating or editing content.
System fieldsAll default, and custom content types come with some managed system fields. These fields reflect certain states of your content, such as when it was last updated, or published at.

#Content stages

This list offers a brief description of the two content stages every Hygraph project has by default.

Stage nameDescription
DraftContent that has never been published. Draft content can be added, edited and saved, without affecting published content.
PublishedPublished content. If the published button displays green, it means content that has been pushed live. If the published button displays blue, it means a new draft version has been saved and the published content is now outdated.

Additionally, you can create custom content stages for your project. Click to find out more.

#Widgets

This lists offer a brief description of the widgets available in Hygraph's schema editor.

#Field widgets

Widget nameDescription
Single line textString type field widget. It is used for adding headings and titles.
Multi line textString type field widget. It is used for adding text such as descriptions.
MarkdownString type field widget. This widget is a markdown editor.
SlugString type field widget. It is used for adding URL friendly identifiers to your content.
Rich textText type field widget. This widget is a text editor with formatting.
NumberInteger type field widget. It is used for adding a numeric field, such as an ID or identifier.
FloatFloat type field widget. It is used for adding numbers that are not integers because they can include decimal values, for example, ratings or prices.
BooleanBoolean type field widget. It is used for adding a switch that represents true/false.
DateDate type field widget. This is a calendar date picker.
Date and timeDate and time type field widget. This is a calendar date picker that includes time.
JSON editorJSON type field widget. It allows adding arbitrary JSON structures.
Cloudinary assetJSON type field widget. It allows picking assets from Cloudinary.
Asset pickerAsset type field widget. It allows selecting assets from your project, and supports any file type.
ColorColor type field widget. Supports HEX and RGBA.
MapLocation type field widget. Allows adding geo coordinates to your content.
DropdownEnumeration type field widget. Allows adding a dropdown list of values to your content.
Basic ComponentComponent type field widget. This basic widget is used for single components. Click here to learn more about Components.
Modular ComponentModular component type field widget. This modular widget is used for multiple components. Click here to learn more about Components.
ReferenceRelation type field widget. It is used for content relationships.
RESTREST type field widget. It is used to add external data via REST.
GraphQLGraphQL type field widget. It is used to add external data via GraphQL.
Widget nameDescription
Entry informationSystem sidebar widget, added to your model by default. It offers basic entry information.
LocalizationsSystem sidebar widget, added to your model by default. It allows viewing localized fields.
StagesSystem sidebar widget, added to your model by default. It allows viewing in-app content stages.
VersionsSystem sidebar widget, added to your model by default. It allows viewing the evolution of your content.
ScheduleSystem sidebar widget, added to your model by default. It allows scheduling entries to be published later.
PreviewSystem sidebar widget. It allows previewing content changes by adding a preview link to your content.

Click here to know more about system fields.

#Components

ConceptDescription
ComponentA component is a predefined set of fields that can be reused across models and content entries.
Component instanceA specific occurrence of the component type, containing content, inside a content entry.
Component fieldA special field type in your Hygraph schema that defines which components of which type can be used in a model. Component fields can be of basic or modular types.
Nested componentsFunctionality that allows you to create components within a component.

Click here to know more about components.