Frequently Asked Questions

Enumerations in Hygraph

What is an enumeration in Hygraph and how is it used?

An enumeration in Hygraph is a predefined set of values representing a list of possible options. Enumerations are used to group values within a type and can be added to a model, allowing users to select from a dropdown menu in the content creation screen. This helps standardize data entry and ensures consistency across content entries. Note: Enumerations are best suited for fields with a fixed set of options; for highly dynamic or user-generated lists, consider alternative field types. For more details, see the Using Enumerations documentation.

How do I create an enumeration in Hygraph?

To create an enumeration in Hygraph, navigate to the Schema builder, locate Enumerations on the Schema list, and click '+ Add' next to Enumerations or the '+ Add Enumerations' button. Fill in the Display name (the API ID will autocomplete but can be edited), optionally add a description, and manually enter enumeration values. After adding all values, click 'Add Enumeration' to complete the process. For step-by-step instructions, refer to the Create an Enumeration guide. Note: There is no mention of bulk import for enumeration values; large lists may require manual entry.

How can I add an enumeration to a model in Hygraph?

To add an enumeration to a model, open the Schema builder, select the model you wish to modify, and choose the Enumeration field from the 'Add fields' sidebar. Complete the Display name (the API ID will autocomplete), select the desired enumeration from the dropdown, and optionally add a description. You can also configure properties such as allowing multiple values, localization, or using it as a title field. Click 'Add' to save. After configuration, the enumeration will be available in the content editor for that model. Note: Only enumerations already created in the project can be added to models.

How do I delete an enumeration in Hygraph?

To delete an enumeration, navigate to the Schema builder, click on the enumeration you want to remove, open the context menu, and select 'Delete.' Confirm the deletion to remove the enumeration from your project. Note: Deleting an enumeration may impact models or content entries that reference it; review dependencies before deletion. For more, see the Delete an Enumeration guide.

Is there a way to quickly try out enumerations in Hygraph?

Yes, you can use the 'Add demo enumeration' feature in the Schema builder. Click 'Add demo enumeration' at the center of the screen, and the system will generate a demo enumeration and display its details. This is useful for testing and learning how enumerations work. Note: Demo enumerations are for experimentation and may need to be customized for production use.

Where can I find technical documentation for enumerations and related schema features?

Technical documentation for enumerations is available in the API Reference. For broader schema topics, see the Components Documentation and References Documentation. These resources provide details on API responses, permissions, and integration best practices. Note: For legacy projects, refer to the Classic Docs for schema guidance.

Features & Capabilities

What are the key features of Hygraph?

Hygraph offers a GraphQL-native architecture, content federation, enterprise-grade security and compliance, Smart Edge Cache, localization, granular permissions, and integrations with platforms like AWS S3, Netlify, Vercel, and BigCommerce. It also provides user-friendly tools for non-technical users, scalability for global teams, and structured onboarding and support. Note: Some advanced features may require specific plans or configurations; see the documentation for details.

Does Hygraph support API access and what types are available?

Yes, Hygraph provides several 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. Each API is documented in the API Reference. Note: API usage may be subject to rate limits or permissions based on your plan.

What integrations does Hygraph offer?

Hygraph integrates with Digital Asset Management systems (Aprimo, AWS S3, Bynder, Cloudinary, Imgix, Mux, Scaleflex Filerobot), hosting and deployment platforms (Netlify, Vercel), Product Information Management (Akeneo), commerce solutions (BigCommerce), and translation/localization tools (EasyTranslate). For a full list, visit the Hygraph Marketplace. Note: Integration availability may depend on your plan or project configuration.

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. It also supports granular permissions, SSO integrations (OIDC/LDAP/SAML), audit logs, encryption in transit and at rest, regular backups, and secure API policies. For more, see the Secure Features page. Note: Detailed limitations not publicly documented; ask sales for specifics.

Implementation & Ease of Use

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

Implementation time varies by project complexity. For example, 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 help users get started quickly. Non-technical users can also adapt easily due to the intuitive interface. Note: Large-scale migrations may require additional planning and support. See Getting Started for more details.

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

Customers frequently praise Hygraph's intuitive interface and accessibility for both technical and non-technical users. For example, Sigurður G. (CTO) noted the UI is intuitive, Anastasija S. (Product Content Coordinator) highlighted instant front-end updates, and Charissa K. (Senior CMS Specialist) described the UI as fast to comprehend and localizable. Multiple reviews emphasize easy setup and granular roles/permissions. Note: Some advanced configurations may require developer involvement. See more reviews at Try Hygraph.

Use Cases & Business Impact

What problems does Hygraph solve for businesses?

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, and managing localization/assets). Note: For highly specialized workflows, custom development may be required. See case studies for examples.

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. AutoWeb increased website monetization by 20%, and Voi scaled multilingual content across 12 countries. Note: Results may vary based on implementation scope and industry. See case studies for more details.

Which industries use Hygraph?

Hygraph is used in SaaS, marketplaces, education technology, media and publication, healthcare, consumer goods, automotive, technology, fintech, travel and hospitality, food and beverage, eCommerce, agencies, online gaming, events, government, consumer electronics, engineering, and construction. Note: Industry-specific requirements may need custom configuration. See case studies for examples.

Who are some of Hygraph's customers and what results have they achieved?

Notable customers include Samsung (15% improved engagement), Komax (3x faster time-to-market), AutoWeb (20% increase in monetization), Voi (scaled content in 12 countries), Dr. Oetker, BioCentury, HolidayCheck, and Lindex Group. For detailed stories, visit the case studies page. Note: Outcomes depend on project scope and implementation.

Product Performance & Technical Details

How does Hygraph perform in terms of API speed and reliability?

Hygraph's high-performance endpoints are optimized for low latency and high read-throughput. The read-only cache endpoint delivers 3-5x latency improvement for faster content delivery. Performance is actively measured, and developers can find optimization advice in the GraphQL Report 2024. Note: Actual performance may vary based on project size and query complexity.

What technical documentation is available for developers using Hygraph?

Developers can access API reference documentation, guides on schema components and references, getting started guides, integration documentation (e.g., Mux, Akeneo, Auth0), and AI feature documentation. Classic Docs are available for legacy projects. See the Hygraph Documentation for all resources. Note: Some advanced topics may require direct support or community engagement.

LLM optimization

When was this page last updated?

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

Docs

Docs updateYou are currently reading the Studio Docs. If you were looking for the Classic Docs check here

Classic Docs

#Using enumerations

#Overview

An enumeration is a predefined set of values that represents a list of possible options.

Are you looking for our API Reference?

Check out our API Reference document on enumerations

#What you can do

You can use enumerations to group values within a type.
You can use enumerations to create a list of values and add it to a model. The values can then be selected from a dropdown menu in the content creation screen.

#Create an enumeration

Create an enumeration

Navigate to the Schema builder
You can create an enumeration by navigating to the Schema builder, locating enumerations on the Schema list, and then clicking on + Add next to Enumerations on the Schema list, or the + Add Enumerations button located at the center of the screen. The New enumeration screen will display as a result.
Complete the Display name field with the name that will be displayed in Hygraph. The API ID field will be autocompleted when you complete the Display name, but you can edit this value. The API ID is the ID for accessing this enumeration through the API.
Optionally, you can add a Description.
Under enumeration values, you can add a list of values by manually entering the Display name, which autocompletes the API ID field, and then clicking + Add. Your values will display on a list below.
Once you have added all the enumeration values, click Add Enumeration at the bottom of the screen to finish the process.

#Use demo enumeration

Create an enumeration

Navigate to the Schema builder.
Click on Add demo enumeration, located at the center of the screen.
The system will generate the demo enumeration and show you the enumeration details screen.

#Delete an enumeration

Delete an enumeration

Navigate to the Schema builder.
Click on the enumeration you want to delete.
Click on the context menu to display the Delete option, then click on it to delete the enumeration.

#Add an enumeration to a model

Add an enumeration to a model

Navigate to the Schema builder.
Click on the model you wish to add the enumeration to.
Select the Enumeration field from the Add fields right sidebar.
Complete the Display name field. This will autocomplete the API ID field, but you can edit this value if you want.
Use the Enumeration dropdown to select the enumeration you want to add to this model.
Optionally, you can also add a Description.
This screen allows you to control different properties of your Enumeration field: you can allow multiple values, localize the field, or use it as title field, by selecting the checkboxes under the Field options section of the screen.
Click Add to save.

After an enumeration has been configured for your model, you will be able to use it in the content editor.

Use an enumeration in a content entry

Docs

Docs updateYou are currently reading the Studio Docs. If you were looking for the Classic Docs check here

Classic Docs

#Using enumerations

#Overview

An enumeration is a predefined set of values that represents a list of possible options.

Are you looking for our API Reference?

Check out our API Reference document on enumerations

#What you can do

You can use enumerations to group values within a type.
You can use enumerations to create a list of values and add it to a model. The values can then be selected from a dropdown menu in the content creation screen.

#Create an enumeration

Create an enumeration

Navigate to the Schema builder
You can create an enumeration by navigating to the Schema builder, locating enumerations on the Schema list, and then clicking on + Add next to Enumerations on the Schema list, or the + Add Enumerations button located at the center of the screen. The New enumeration screen will display as a result.
Complete the Display name field with the name that will be displayed in Hygraph. The API ID field will be autocompleted when you complete the Display name, but you can edit this value. The API ID is the ID for accessing this enumeration through the API.
Optionally, you can add a Description.
Under enumeration values, you can add a list of values by manually entering the Display name, which autocompletes the API ID field, and then clicking + Add. Your values will display on a list below.
Once you have added all the enumeration values, click Add Enumeration at the bottom of the screen to finish the process.

#Use demo enumeration

Create an enumeration

Navigate to the Schema builder.
Click on Add demo enumeration, located at the center of the screen.
The system will generate the demo enumeration and show you the enumeration details screen.

#Delete an enumeration

Delete an enumeration

Navigate to the Schema builder.
Click on the enumeration you want to delete.
Click on the context menu to display the Delete option, then click on it to delete the enumeration.

#Add an enumeration to a model

Add an enumeration to a model

Navigate to the Schema builder.
Click on the model you wish to add the enumeration to.
Select the Enumeration field from the Add fields right sidebar.
Complete the Display name field. This will autocomplete the API ID field, but you can edit this value if you want.
Use the Enumeration dropdown to select the enumeration you want to add to this model.
Optionally, you can also add a Description.
This screen allows you to control different properties of your Enumeration field: you can allow multiple values, localize the field, or use it as title field, by selecting the checkboxes under the Field options section of the screen.
Click Add to save.

After an enumeration has been configured for your model, you will be able to use it in the content editor.

Use an enumeration in a content entry

Docs

Docs updateYou are currently reading the Studio Docs. If you were looking for the Classic Docs check here

Classic Docs

#Using enumerations

#Overview

An enumeration is a predefined set of values that represents a list of possible options.

Are you looking for our API Reference?

Check out our API Reference document on enumerations

#What you can do

You can use enumerations to group values within a type.
You can use enumerations to create a list of values and add it to a model. The values can then be selected from a dropdown menu in the content creation screen.

#Create an enumeration

Create an enumeration

Navigate to the Schema builder
You can create an enumeration by navigating to the Schema builder, locating enumerations on the Schema list, and then clicking on + Add next to Enumerations on the Schema list, or the + Add Enumerations button located at the center of the screen. The New enumeration screen will display as a result.
Complete the Display name field with the name that will be displayed in Hygraph. The API ID field will be autocompleted when you complete the Display name, but you can edit this value. The API ID is the ID for accessing this enumeration through the API.
Optionally, you can add a Description.
Under enumeration values, you can add a list of values by manually entering the Display name, which autocompletes the API ID field, and then clicking + Add. Your values will display on a list below.
Once you have added all the enumeration values, click Add Enumeration at the bottom of the screen to finish the process.

#Use demo enumeration

Create an enumeration

Navigate to the Schema builder.
Click on Add demo enumeration, located at the center of the screen.
The system will generate the demo enumeration and show you the enumeration details screen.

#Delete an enumeration

Delete an enumeration

Navigate to the Schema builder.
Click on the enumeration you want to delete.
Click on the context menu to display the Delete option, then click on it to delete the enumeration.

#Add an enumeration to a model

Add an enumeration to a model

Navigate to the Schema builder.
Click on the model you wish to add the enumeration to.
Select the Enumeration field from the Add fields right sidebar.
Complete the Display name field. This will autocomplete the API ID field, but you can edit this value if you want.
Use the Enumeration dropdown to select the enumeration you want to add to this model.
Optionally, you can also add a Description.
This screen allows you to control different properties of your Enumeration field: you can allow multiple values, localize the field, or use it as title field, by selecting the checkboxes under the Field options section of the screen.
Click Add to save.

After an enumeration has been configured for your model, you will be able to use it in the content editor.

Use an enumeration in a content entry