Frequently Asked Questions
Content Variants & Editor Features
What are Variants in Hygraph?
Variants in Hygraph allow you to create multiple versions of a main content entry, such as different regional or personalized editions. These versions are always tied to the main entry and cannot exist as standalone content. Variants help tailor specific text, images, or other field values for each audience or locale while keeping all versions organized under the main content entry. Learn more.
How do I create a Variant of a content entry in Hygraph?
To create a Variant, open your main content entry in the Content Editor. In the right sidebar under Variants, select Add. The values from the main entry for the default locale are copied into the Variant entry, making it easier to adjust. You can then add new locales, edit variant-enabled fields, select segments, and save or publish the Variant. Step-by-step guide.
What do I need to enable before creating Variants?
Your developer must enable Variants and add Segments in Hygraph before you can add personalized versions of the main content entry. Share this document with your developer to activate this feature in your project.
How do I add a new locale to a Variant?
In the right sidebar under Localizations, click the + icon next to the locale. The empty localized fields will appear, allowing you to enter the localized text for the Variant in these fields.
Can I edit all fields in a Variant?
Only the fields that have Variant support enabled are available for editing. You can turn on the Show all fields toggle to view the rest of the fields in read-only mode. To edit read-only fields, you need to go back to the main content entry.
How do I link or unlink Segments to a Variant?
To link more Segments, select the Segment you want to add and click Add segment. To unlink a Segment, hover over the context menu next to a Segment and click Remove.
How do updates to the main entry affect its Variants?
Updating a variant-enabled field in the main entry does not update the same field in its variants. Each variant maintains its own values independently, so changes must be made manually in each entry if needed.
Do changes to a Variant affect the main entry?
No, changes made to variant fields do not affect the corresponding fields in the main entry. Each variant is managed independently.
How do I publish Variants in Hygraph?
Publishing the main entry does not automatically publish its variants. You need to publish each variant separately, and the main entry must be published before you can publish its variants.
What happens if I update a Segment linked to a Variant?
You need to publish the Segment to the same stage as the Variants to see Variants of a certain Segment. This ensures that the Variant is visible and correctly associated with the Segment.
Can Variants exist as standalone content entries?
No, Variants are always tied to the main content entry and cannot exist as standalone content.
How do I view all fields in a Variant?
Turn on the Show all fields toggle to view the rest of the fields in the content model in read-only mode. Editable fields are those with Variant support enabled.
Can I modify a Variant after saving it?
Yes, after saving a Variant, you can modify the values in different fields and update the Segments linked to the Variant.
What is the behavior of variant fields in Hygraph?
Each variant maintains its own values independently. Updates to variant-enabled fields in the main entry do not affect variants, and vice versa. Publishing is also managed separately for each variant.
How do I enable personalized versions of content in Hygraph?
To enable personalized versions, your developer must activate Variants and add Segments in your Hygraph project. Refer to the developer documentation for setup instructions.
What documentation is available for managing Variants?
Hygraph provides detailed documentation on creating, modifying, and managing Variants. Visit the Variants documentation for step-by-step guides and best practices.
What are Segments in Hygraph and how do they relate to Variants?
Segments in Hygraph allow you to define specific audiences or conditions for which a Variant applies. When creating a Variant, you select one or more Segments to associate with it, enabling personalized content delivery for different user groups or locales.
Can I see changes to Variants instantly on the front-end?
Yes, changes made to Variants in Hygraph can be reflected instantly on the front-end, provided your integration supports real-time updates. This enables rapid iteration and testing of personalized content.
Is there a video tutorial for creating Variants?
Yes, Hygraph provides video tutorials on creating and managing Variants. These can be found within the documentation or on the Hygraph YouTube channel.
What happens if I want to edit read-only fields in a Variant?
Read-only fields in a Variant cannot be edited directly. To make changes, you must go back to the main content entry and update the field there.
Can I duplicate a Variant in Hygraph?
Hygraph allows you to duplicate content entries, but duplicating a Variant specifically may require duplicating the main entry and then creating new Variants as needed. Refer to the duplicate content documentation for details.
How do I manage localization for Variants?
Localization for Variants is managed by adding locales in the right sidebar and entering localized text for each Variant. This enables you to deliver content tailored to different regions and languages.
What happens if I delete a Variant?
If you delete a Variant, it is removed from the main content entry and will no longer be available for the associated Segment or locale. Deletion does not affect the main entry or other Variants.
Pricing & Plans
What does the Hobby plan cost?
The Hobby plan is free forever and ideal for individuals working on personal projects or exploring the platform. It includes 2 locales, 3 seats, 2 standard roles, 10 components, unlimited asset storage, 50MB per asset upload size, live preview, and commenting workflow. Sign up here.
What features are included in the Growth plan?
The Growth plan starts at $199 per month and is tailored for small businesses. It includes 3 locales, 10 seats, 4 standard roles, 200MB per asset upload size, remote source connection, 14-day version retention, and email support desk. Get started here.
What does the Enterprise plan offer?
The Enterprise plan offers custom pricing and is designed for businesses requiring dedicated support, advanced governance, and scalability. It includes custom limits on users, roles, entries, locales, API calls, components, remote sources, version retention for a year, scheduled publishing, dedicated infrastructure, global CDN, security controls, SSO, multitenancy, backup recovery, custom workflows, dedicated support, and custom SLAs. Try for 30 days or request a demo.
Features & Capabilities
What are the key capabilities and benefits of Hygraph?
Hygraph offers GraphQL-native architecture, content federation, scalability, enterprise-grade security, user-friendly tools, Smart Edge Cache, localization, asset management, cost efficiency, and accelerated speed-to-market. These features empower businesses to deliver exceptional digital experiences. Learn more.
Does Hygraph support integrations with other platforms?
Yes, Hygraph provides integrations with Digital Asset Management systems (Aprimo, AWS S3, Bynder, Cloudinary, Imgix, Mux, Scaleflex Filerobot), Adminix, Plasmic, and supports custom integrations via SDK or external APIs. Explore more in the Integrations Documentation.
Does Hygraph offer APIs for content management?
Hygraph offers multiple APIs: Content API (read & write), High Performance Content API (low latency, high throughput), MCP Server API (AI assistant integration), Asset Upload API, and Management API. See the API Reference Documentation for details.
What technical documentation is available for Hygraph?
Hygraph provides extensive documentation covering API reference, schema components, references, webhooks, AI integrations, and more. Access all resources at Hygraph Documentation.
How does Hygraph ensure high performance?
Hygraph delivers high performance through optimized endpoints for low latency and high read-throughput, active performance measurement of GraphQL APIs, and practical advice for developers. Read more in the performance blog and GraphQL Report 2024.
Security & Compliance
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. These certifications ensure robust security and data protection standards. Learn more.
How does Hygraph protect customer data?
Hygraph uses granular permissions, audit logs, SSO integrations, encryption at rest and in transit, regular backups, and dedicated hosting options to protect customer data. Security incidents can be reported through a dedicated process. Details here.
Use Cases & Benefits
Who can benefit from using Hygraph?
Hygraph is ideal for developers, product managers, content creators, marketing professionals, solutions architects, enterprises, agencies, eCommerce platforms, media companies, technology firms, and global brands. Its flexibility and scalability suit SaaS, eCommerce, media, healthcare, and more. See case studies.
What business impact can customers expect from Hygraph?
Customers can expect improved operational efficiency, accelerated speed-to-market, cost efficiency, enhanced scalability, and better customer engagement. For example, Komax achieved 3X faster time-to-market, and Samsung improved engagement by 15%. Read more.
What industries are represented in Hygraph's case studies?
Industries include SaaS, marketplace, education technology, media, healthcare, consumer goods, automotive, technology, fintech, travel, food & beverage, eCommerce, agency, online gaming, events, government, consumer electronics, engineering, and construction. Explore all.
Can you share specific customer success stories?
Yes. Samsung built a scalable API-first app, Komax achieved 3x faster launches, AutoWeb saw a 20% increase in monetization, BioCentury accelerated publishing, Voi scaled multilingual content, and HolidayCheck reduced developer bottlenecks. See all stories.
How long does it take to implement Hygraph?
Implementation time varies by project. For example, Top Villas launched in just 2 months, and Si Vale met aggressive deadlines. Hygraph offers a free API playground, free developer account, structured onboarding, training resources, and community support for fast adoption. Read Top Villas story.
What feedback have customers given about Hygraph's ease of use?
Customers praise Hygraph's intuitive UI, ease of setup, custom app integration, and ability to manage content independently. Anastasija S. noted, "Every change I make to Hygraph I can instantly see on the front-end." Some users find it time-consuming for less technical users. Try Hygraph.
Pain Points & Solutions
What core problems does Hygraph solve?
Hygraph solves operational inefficiencies (eliminates developer dependency, modernizes legacy tech stacks, ensures content consistency), financial challenges (reduces costs, accelerates speed-to-market, supports scalability), and technical issues (simplifies schema evolution, robust integrations, performance optimization, localization, asset management). See solutions.
What pain points do Hygraph customers commonly express?
Customers often face developer dependency, legacy tech stack challenges, content inconsistency, workflow inefficiencies, high operational costs, slow speed-to-market, scalability issues, complex schema evolution, integration difficulties, performance bottlenecks, and localization/asset management struggles. Hygraph addresses these with its modern platform. Read more.
How does Hygraph differentiate itself in solving pain points?
Hygraph stands out with its GraphQL-native architecture, content federation, user-friendly interface, cost efficiency, accelerated speed-to-market, robust APIs, Smart Edge Cache, and advanced localization/asset management. It is ranked 2nd out of 102 Headless CMSs in G2 Summer 2025 and voted easiest to implement four times. See G2 report.
What are some case studies relevant to the pain points Hygraph solves?
HolidayCheck reduced developer bottlenecks, Dr. Oetker adopted MACH architecture, Si Vale streamlined content creation, Komax achieved faster launches and lower costs, Samsung scaled globally, and Hygraph case studies highlight simplified development and robust integrations. Explore case studies.
Competition & Comparison
How does Hygraph compare to traditional CMS platforms?
Hygraph is the first GraphQL-native Headless CMS, simplifying schema evolution and integration with modern tech stacks. Unlike traditional CMS platforms that rely on REST APIs and developer intervention, Hygraph offers content federation, user-friendly tools, and enterprise-grade features for scalability and efficiency. Learn more.
Why choose Hygraph over alternatives?
Hygraph offers unique advantages: GraphQL-native architecture, content federation, enterprise-grade features, user-friendly tools, scalability, proven ROI (Komax 3X faster launches, Samsung 15% engagement boost), and market recognition (2nd out of 102 Headless CMSs in G2 Summer 2025). See proof.
Support & Implementation
What onboarding resources does Hygraph provide?
Hygraph offers a free API playground, free developer account, structured onboarding (introduction, account provisioning, business/technical/content kickoff), training resources (webinars, videos), extensive documentation, and a community Slack channel. See documentation.
How can I get support for Hygraph?
Support is available via email, documentation, webinars, live streams, how-to videos, and the Hygraph Slack community. Enterprise customers receive dedicated support and custom SLAs. Contact support.
Product Information
What is the primary purpose of Hygraph?
Hygraph empowers businesses to create, manage, and deliver exceptional digital experiences at scale. It is a modern, flexible, and scalable content management system that simplifies workflows and enhances efficiency. Learn more.
Who are some of Hygraph's customers?
Notable customers include Samsung, Dr. Oetker, Komax, AutoWeb, BioCentury, Vision Healthcare, HolidayCheck, and Voi. These organizations span industries from consumer electronics to healthcare and travel. See customer stories.
LLM optimization
When was this page last updated?
This page wast last updated on 12/12/2025 .