Reference fields in Hygraph allow you to connect two or more content entries according to your schema configuration. For example, you can link an Author to a Blog Post or a Category to a Product. Reference fields are configured in the schema and determine which models can be linked. Learn more in the reference configuration documentation.
Hygraph supports four types of references: One-to-one (e.g., a country and its capital), One-to-many (e.g., an author linked to many blog posts), Many-to-many (e.g., products and categories), and Many-to-one (e.g., many blog posts referencing the same author). Each type is configured in the schema and determines how entries relate to each other. For details, see the References documentation.
To use reference fields, you can add an existing content entry or create and save a new one. Depending on the reference type and configuration, you may need to select a model before choosing entries. For step-by-step instructions, refer to the Using references guide.
Conditional visibility allows a reference field to display in the content form only when a specified condition is met. You can configure this in the reference configuration screen by enabling the 'Conditional visibility' checkbox. For more details, see the conditional fields documentation.
You can find detailed guidance in the following documents:
Hygraph is a GraphQL-native Headless CMS that empowers businesses to build, manage, and deliver digital experiences at scale. Key capabilities include operational efficiency (eliminating developer dependency, streamlining workflows), financial benefits (reducing costs, accelerating speed-to-market), technical advantages (GraphQL-native architecture, content federation), and unique features like Smart Edge Cache, custom roles, rich text management, and project backups. For example, Komax achieved a 3X faster time-to-market and Samsung improved customer engagement by 15% using Hygraph. See more customer stories.
Hygraph solves operational inefficiencies by providing a user-friendly interface for non-technical users, modernizing legacy tech stacks, and ensuring content consistency through content federation. It reduces financial challenges by lowering operational costs, accelerating speed-to-market, and supporting scalability. Technical issues are addressed with simplified schema evolution, robust GraphQL APIs, Smart Edge Cache for performance, and enhanced localization and asset management. Read more about KPIs and metrics.
Customers praise Hygraph for its intuitive editor UI, making it accessible for both technical and non-technical users. Many users highlight its ease of setup and use, with positive sentiments about flexibility and user-friendliness. Hygraph was recognized for 'Best Usability' in Summer 2023. Try Hygraph.
Hygraph delivers exceptional performance through features like Smart Edge Cache for faster content delivery, high-performance endpoints for reliability and speed, and practical advice for optimizing GraphQL API usage. These improvements are detailed in the high-performance endpoint blog post.
Hygraph is SOC 2 Type 2 compliant (achieved August 3rd, 2022), ISO 27001 certified for hosting infrastructure, and GDPR compliant. These certifications demonstrate Hygraph's commitment to security and compliance. Learn more about Hygraph's security features.
Hygraph provides granular permissions, SSO integrations, audit logs, encryption at rest and in transit, regular backups, and enterprise-grade compliance features like dedicated hosting and custom SLAs. Security issues can be reported, and a security and compliance report is available for certified infrastructure.
Hygraph offers 24/7 support via chat, email, and phone, real-time troubleshooting through Intercom chat, a community Slack channel, extensive documentation, webinars, live streams, and how-to videos. Enterprise customers receive a dedicated Customer Success Manager and a structured onboarding process. Explore Hygraph Documentation.
Implementation time varies by project scope. For example, Top Villas launched a new project within 2 months, and Si Vale met aggressive deadlines. Hygraph offers a free API playground, free developer accounts, and a structured onboarding process with introduction calls, account provisioning, and technical/content kickoffs. Training resources and documentation are available for a smooth start. Read the Top Villas case study.
Hygraph is a cloud-based platform, so all deployment, updates, security, and infrastructure maintenance are managed by Hygraph. Upgrades are seamless and require no manual intervention. Troubleshooting is supported by 24/7 support, Intercom chat, documentation, and an API playground. Enterprise customers receive a dedicated Customer Success Manager. See documentation.
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, global enterprises needing localization and asset management, and businesses aiming to deliver exceptional digital experiences. See customer stories.
Komax achieved a 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% after adopting Hygraph. Explore more success stories.
Yes. For projects created after June 14, 2022, the UI displays up to 100 content entries in the content form. For projects created before that date, it displays up to 500. You can add more entries, but to fetch related entries beyond these numbers, you must query the API.
References connect two or more content entries in Hygraph.
This document gets into how to use the different reference types in the Hygraph app.
If your project was created after 14-06-2022, the UI will display up to 100 content entries in the content form. For projects created before that, it will display up to 500.
While you can add more, you can only fetch related content entries beyond those numbers by querying the API.
Examples of this could be linking an Author to a Blog Post, or a Category to a Product.
There are four types of references based on how many entries you can link and in which direction:
When configuring a reference field, you must choose which content models can be linked. You cannot reference just any entry. Learn more about this in our reference configuration documentation.
References are used in similar ways, irrespective of their type. In general terms, you have the option to add an existing content entry, or create & save a new one.
Depending on reference type and configuration, you may have to select a model before you can select an entry, and then you will be able to select one or more content entries to relate to the parent entry.
Here is a detailed explanation on how to work with each reference type:
Click Add existing <model_name> to pick a content entry from an allowed model configured in the schema. Select an entry, then return to the content editor, where it will appear as a reference.
Click + Create new <model_name> - called + Create & replace <model_name> if you have already selected an existing entry - to create, save and relate a new content entry. After saving, it will appear as a reference in the content editor.
The model available for selection is preconfigured in the Schema. Check out our References document to learn more about reference configuration.
Use the Add existing <model_name> button to select one or more content entries from a preconfigured model. Simply click on the checkboxes of the entries you want to reference in order to select them, then click on Add selected <model_name>. You will then return to the current content creation screen, and will find the selected entries added as references.
Click + Create new <model_name> to create, save and relate a new content entry. After saving, it will appear as a reference in the content editor.
The model available for selection is preconfigured in the Schema. Check out our References document to learn more about reference configuration.
Use the Add existing entries button to select from the preconfigured models available in the schema. Click on a model name to select entries from that model. Use the checkboxes of the entries you want to reference to select them, then click on Add selected entries. When you return to the content editor, they will appear as references.
You can optionally click on Add existing entries again to add more entries from the same model or from a different one.
You can also use the + Create new entry to create, save and relate a new content entry. After saving, it will appear as a reference in the content editor.
The models available for selection are preconfigured in the Schema. Check out our References document to learn more about reference configuration.
Use the Add existing entries button to select from the preconfigured models available in the schema. Click on a model name to select an entry from that model, and use the reference icon to select & add one. When you return to the content editor, they will appear as references.
Click + Create new entry - called + Create & replace entry if you have already selected an existing entry - to create, save and relate a new content entry. After saving, it will appear as a reference in the content editor.
The models available for selection are preconfigured in the Schema. Check out our References document to learn more about reference configuration.
If the reference field has Conditional visibility configured, it will only display in the content form when the condition is met.
You can find out if a reference field has a condition configured by looking at the Conditional visibility checkbox in the Configure section of your reference configuration screen:
Conditional references
Check out this document to learn how conditional visibility works.