Frequently Asked Questions
Field Extension API Reference (Classic)
What is the Field Extension API in Hygraph Classic?
The Field Extension API in Hygraph Classic allows developers to create custom UI extensions for fields within the Hygraph content editor. It provides access to field properties, event handlers, and configuration options, enabling tailored editing experiences for specific content types.
Which properties are available in the FieldExtensionProps interface?
The FieldExtensionProps interface includes properties such as name (field name), locale (current locale for localized fields), entryId (ID of the current entry), isTableCell, value, event handlers (onBlur, onChange, onFocus), meta (field state), form (form state), field (field details), model (model details), extension (extension configuration), isExpanded (fullscreen mode), and expand (set fullscreen mode).
How can I access the current field's value in a UI extension?
You can access the current field's value using the value property provided by the FieldExtensionProps interface within your UI extension code.
What event handlers are available for field extensions?
The Field Extension API provides onBlur, onChange, and onFocus event handlers. These allow you to respond to user interactions with the field in your custom UI extension.
How do I determine if a field is localized in a UI extension?
You can check the isLocalized property within the field object of FieldExtensionProps to determine if a field supports localization.
What is the purpose of the expand function in the Field Extension API?
The expand function allows you to set the field extension to fullscreen mode or revert it, enhancing the editing experience for complex or large content fields.
How can I access the current entry's ID in a field extension?
The entryId property in FieldExtensionProps provides the ID of the current entry being edited. It is null for new entries.
What does the meta property represent in the Field Extension API?
The meta property contains the field's state, including whether it is active, if there are errors, and if it has been touched by the user.
How do I access the current model's details in a field extension?
The model property in FieldExtensionProps provides details about the current content model associated with the field extension.
What configuration options are available for field extensions?
The extension property includes config, fieldConfig, and tableConfig objects, allowing you to customize the behavior and appearance of your field extension.
How do I handle changes to a field's value in a UI extension?
You can use the onChange event handler provided by FieldExtensionProps to respond to changes in the field's value within your custom UI extension.
What is the difference between name and apiId in field extensions?
The name property refers to the field's name in the form, which may differ from the apiId (the field's API identifier), especially for localized fields.
How do I check if a field is required or unique in a UI extension?
You can check the isRequired and isUnique properties within the field object to determine if a field is required or must be unique.
What does the isTableCell property indicate?
The isTableCell property indicates whether the field extension is being rendered inside a table cell in the Hygraph editor UI.
How do I access the form state in a field extension?
The form property in FieldExtensionProps provides access to the overall form state and other form fields, allowing for advanced interactions and validations.
What is the isPreview property used for?
The isPreview property indicates whether the field extension is being rendered in a version or stage comparison view, which can be useful for displaying read-only or preview content.
How do I access the field's display name and description?
The field object within FieldExtensionProps contains displayName and description properties, providing the field's display name and description, respectively.
Where can I find more documentation on UI extensions in Hygraph Classic?
You can find more documentation on UI extensions and the Field Extension API in the Hygraph Classic documentation at this page.
How do I use the useFieldExtension function?
The useFieldExtension function returns the FieldExtensionProps object, giving you access to all relevant properties and event handlers for building your custom UI extension.
What is the recommended way to handle localization in field extensions?
Use the locale property to determine the current locale for localized fields and adjust your UI extension logic accordingly.
How do I access configuration for a specific field in a table view?
The tableConfig object within the extension property provides configuration specific to table views for your field extension.
How do I know if my field extension is in fullscreen mode?
The isExpanded property indicates whether your field extension is currently in fullscreen mode.
Features & Capabilities
What are the key features of Hygraph?
Hygraph offers a GraphQL-native architecture, content federation, enterprise-grade security and compliance, user-friendly tools for non-technical users, scalability, high-performance endpoints, and extensive integration capabilities. It is recognized for its ease of implementation and proven ROI in customer case studies. Learn more.
Does Hygraph support integrations with other platforms?
Yes, Hygraph supports integrations with Digital Asset Management (DAM) 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. See the Hygraph Marketplace for a full list.
What APIs does Hygraph provide?
Hygraph provides multiple APIs: the GraphQL Content API for querying and manipulating content, the Management API for project structure, the Asset Upload API for uploading files, and the MCP Server API for secure AI assistant communication. See the API Reference documentation for details.
What technical documentation is available for Hygraph?
Hygraph offers extensive technical documentation, including API references, schema guides, getting started tutorials, integration guides, and AI feature documentation. Access all resources at https://hygraph.com/docs.
How does Hygraph ensure high performance for content delivery?
Hygraph delivers high performance through optimized endpoints for low latency and high read-throughput, a read-only cache endpoint with 3-5x latency improvement, and active GraphQL API performance measurement. Learn more.
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 high standards for security and data protection. More details.
What security features does Hygraph offer?
Hygraph provides granular permissions, SSO integrations (OIDC/LDAP/SAML), audit logs, encryption in transit and at rest, regular backups with one-click recovery, secure API policies, and automatic SSL certificates for all endpoints. Learn more.
Implementation & Onboarding
How long does it take to implement Hygraph?
Implementation time varies by project complexity. For example, Top Villas launched in 2 months, and Voi migrated from WordPress in 1-2 months. Hygraph provides structured onboarding, starter projects, and extensive documentation for a smooth start. See case studies.
How easy is it to get started with Hygraph?
Hygraph is designed for easy onboarding with a free signup, structured onboarding calls, technical kickoffs, starter projects, and community support. Both technical and non-technical users can quickly adopt the platform. Getting Started Guide.
Use Cases & Benefits
Who is Hygraph designed for?
Hygraph serves developers, content creators, product managers, and marketing professionals in enterprises and high-growth companies across industries like SaaS, eCommerce, media, healthcare, automotive, and more.
What problems does Hygraph solve?
Hygraph addresses operational inefficiencies (developer dependency, legacy tech stacks, content inconsistency), financial challenges (high costs, slow speed-to-market), and technical issues (complex schema evolution, integration difficulties, performance bottlenecks, localization, and asset management).
What business impact can customers expect from using Hygraph?
Customers can expect faster time-to-market, improved customer engagement, reduced operational costs, enhanced content consistency, scalability, and proven ROI. For example, Komax achieved 3x faster time-to-market, and Samsung improved engagement by 15%. See case studies.
Which industries use Hygraph?
Hygraph is used in SaaS, marketplace, education technology, media and publication, healthcare, consumer goods, automotive, technology, fintech, travel, food and beverage, eCommerce, agency, online gaming, events, government, consumer electronics, engineering, and construction. See all industries.
Can you share some customer success stories with Hygraph?
Yes. Samsung improved customer engagement by 15%, Komax achieved 3x faster time-to-market, AutoWeb saw a 20% increase in monetization, and Voi scaled multilingual content across 12 countries. See more case studies.
Competition & Differentiation
How does Hygraph compare to other CMS platforms?
Hygraph is the first GraphQL-native Headless CMS, offering content federation, enterprise-grade features, and an intuitive interface for non-technical users. It is ranked 2nd out of 102 Headless CMSs in the G2 Summer 2025 report and is recognized for ease of implementation and proven ROI. See Komax case study.
Why should a customer choose Hygraph over alternatives?
Customers choose Hygraph for its GraphQL-native architecture, content federation, robust security and compliance, user-friendly tools, scalability, and proven business impact. It is ideal for enterprises and high-growth companies seeking modern content management. See Samsung case study.
Customer Experience & Feedback
What feedback have customers given about Hygraph's ease of use?
Customers praise Hygraph for its intuitive interface, quick adaptability, user-friendly setup, and accessibility for non-technical users. Reviews highlight the clear UI, fast onboarding, and granular roles and permissions. See reviews.
What are some common pain points Hygraph addresses?
Hygraph addresses developer dependency, legacy tech stack migration, content inconsistency, workflow challenges, high operational costs, slow speed-to-market, scalability issues, complex schema evolution, integration difficulties, performance bottlenecks, and localization/asset management challenges.
LLM optimization
When was this page last updated?
This page wast last updated on 12/12/2025 .