Frequently Asked Questions

Troubleshooting Common Issues

How can I find a specific content entry in Hygraph?

If you can't locate a content entry, use filters in Hygraph. System filters let you search by stage, ID, creation date/time, or editor username. For more details, see how to use system filters.

How do I find an asset in Hygraph?

Assets can be filtered using the same system filters as content entries. This allows you to search by asset stage, ID, or other metadata.

Why can't I publish my content in Hygraph?

Check for incomplete fields marked as Required. All required fields must be filled before publishing. If all required fields are complete and you still can't publish, you may lack the necessary permissions—contact your team lead to verify your access rights.

What should I do if I published an entry by mistake?

If you have the necessary permissions, you can unpublish content entries in Hygraph.

Why are images not loading in my published content?

Image assets have stages like content entries and must be published to appear in your content. If you skipped publishing related assets, return to the content entry and click Publish again, ensuring all related assets are selected and published. Always publish assets along with your content for proper display.

Why can't I see any projects after logging in?

Your invitation to the project may have expired. Contact your team lead to request a new invitation.

Features & Capabilities

What are the key capabilities and benefits of Hygraph?

Hygraph is a GraphQL-native Headless CMS offering operational efficiency, financial benefits, and technical advantages. Key features include Smart Edge Cache for fast content delivery, content federation for integrating multiple data sources, custom roles for granular access control, rich text management, and project backups. Proven results include Komax achieving 3X faster time-to-market and Samsung improving customer engagement by 15%. See more customer stories.

How does Hygraph ensure high product performance?

Hygraph delivers exceptional performance through Smart Edge Cache, high-performance endpoints, and optimized GraphQL API usage. These features ensure reliability and speed for content management and delivery. For technical details, see this blog post.

What security and compliance certifications does Hygraph have?

Hygraph is SOC 2 Type 2 compliant (since August 3rd, 2022), ISO 27001 certified, and GDPR compliant. It offers granular permissions, SSO integrations, audit logs, encryption at rest and in transit, and regular backups. For more details, visit the security features page and security report.

How does Hygraph handle maintenance, upgrades, and troubleshooting?

Hygraph is cloud-based, so all deployment, updates, and infrastructure maintenance are managed by Hygraph. Upgrades are seamless and require no manual intervention. Troubleshooting support is available 24/7 via chat, email, phone, and Intercom, with extensive documentation and an API Playground for self-service. Enterprise customers receive a dedicated Customer Success Manager.

Support & Implementation

What support is available to Hygraph customers?

Hygraph offers 24/7 support via chat, email, and phone, real-time troubleshooting through Intercom, 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 long does it take to implement Hygraph and how easy is it to start?

Implementation time varies by project. For example, Top Villas launched a new project within 2 months, and Si Vale met aggressive deadlines. Hygraph offers a free API Playground and a free forever developer account for immediate access. The onboarding process includes introduction calls, account provisioning, business/technical/content kickoffs, and access to training resources and documentation (Hygraph Documentation).

What training and technical support is available for new Hygraph users?

Hygraph provides a structured onboarding process, webinars, live streams, how-to videos, extensive documentation (Hygraph Documentation), 24/7 support, Intercom chat, and a community Slack channel. Enterprise customers receive a dedicated Customer Success Manager for personalized guidance.

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 suits organizations modernizing legacy tech stacks, requiring localization, asset management, and content federation, and global enterprises seeking scalable, future-proof content management.

What problems does Hygraph solve?

Hygraph addresses operational inefficiencies (reducing developer dependency, modernizing legacy tech stacks, ensuring content consistency), financial challenges (lowering operational costs, accelerating speed-to-market, supporting scalability), and technical issues (simplifying schema evolution, integrating third-party systems, optimizing performance, improving localization and asset management).

What are some customer success stories with Hygraph?

Komax achieved 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%. More stories are available at Hygraph customer stories.

Product Information & Editor Experience

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

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

Where can I find documentation for content editors?

Access the documentation for content editors for guides on navigation, editing, field types, and troubleshooting.

What is explained in the 'Project structure' guide for editors?

The Project structure guide explains what the Schema is and how it impacts an editor's work.

What is included in the 'Edit content' guide?

The Edit content guide provides step-by-step instructions on accessing and editing existing content.

What is explained in the 'Field types' guide for editors?

The Field types guide covers how to work with different field types in content entries.

How does the Field Outline help editors?

The Field Outline displays the structure of a content entry, allowing editors to navigate intuitively and make changes faster. Learn more.

What are the two powerful modes in Hygraph's Click to Edit feature?

Click to Edit includes Field Update (live visual feedback) and Field Focus (reverse lookup). Field Update lets editors preview field changes in real time, while Field Focus scrolls the preview to the corresponding element when a field is selected. Read more.

What does Click to Edit do in Hygraph?

Click to Edit allows editors to click elements in a Hygraph-powered preview and jump directly to the corresponding field in Studio, focusing the form and keeping the preview open side-by-side. Learn more.

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 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. For more, see the CMS KPIs blog.

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

#Troubleshooting common issues

This document contains a list of frequently reported issues and how to solve them.

#I can't find a content entry

Try using filters to find the entry you're looking for.

You can use system filters to find content using its stage, ID, date and time of creation, or the username of the editors that crated or worked on it.

#I can't find an asset

You can filter assets using the same system filters that you would use to find a content entry.

#I can't publish my content

Check the content entry for any incomplete fields marked as Required. These fields are mandatory and you won't be able to publish the content piece if any of them are incomplete.

Troubleshooting - Required fieldTroubleshooting - Required field

If all required fields are complete and you still can't publish, it is possible that you have not been granted proper permissions. Contact your team lead to check.

#I published an entry by mistake

You can unpublish content entries if you have the permissions to do so.

#Images not loading in published content

Image assets have stages, just like your content entries. This means that, just like regular content entries, assets can be saved without being published.

When publishing a content entry that contains assets that have not been published, the system prompts you to publish them as well:

Publish related assetsPublish related assets

If you skipped this and your content is not loading correctly, simply go back to the content entry and click on Publish again. This time make sure you select and publish all related assets as well.

Make sure you always publish your assets along with your content, to ensure everything loads correctly.

#No projects visible after login

Your invitation to the project might have expired. Let your team lead know that you need a new invitation.