Frequently Asked Questions

Content Creation & Editor Usage

How do I create and edit content entries in Hygraph?

To create and edit content entries in Hygraph, navigate to the relevant content model (e.g., Product, Product Category, Seller Information) in the content editor. Click '+ Add entry' to create a new entry, fill in the required fields (such as name, slug, description, images, etc.), and use the 'Save & Publish' button to make your changes live. You can edit existing entries by clicking the pencil icon next to the entry in the content table. Note: The process is consistent across models, but required fields may vary by model. Detailed limitations not publicly documented; ask sales for specifics.

How do I add alt text and captions to images in the Assets model?

To add alt text and captions to images in the Assets model, go to the Assets tab in your Hygraph project. Use the search filter to find the desired image, click the pencil icon to edit, and fill in the 'Alt text' and 'Caption' fields. Click 'Save & Publish' to apply your changes. Repeat this process for each image as needed. Note: This process must be repeated manually for each asset; bulk editing is not documented.

How do I create product categories and relate them to products?

To create product categories, open the Product Category model in the content editor and click '+ Add entry'. Fill in fields such as Category name, Slug, and Description, then 'Save & Publish'. Once products are created, you can relate them to categories using the many-to-many reference field, allowing multiple products per category and vice versa. Note: Relations can only be established after both products and categories exist. Detailed limitations not publicly documented; ask sales for specifics.

How do I add related products to a product entry?

To add related products, edit the desired product entry, scroll to the Related Products component, and click '+ Add Related products'. Use the checkboxes to select up to four existing products to relate, then click 'Add selected products' and 'Save & Publish'. The title section is read-only to ensure consistency. Note: The maximum number of related products is determined by the component configuration; increasing this limit may require schema changes.

How do I create a landing page or campaign page in Hygraph?

To create a landing page, open the Landing Page model in the content editor and click '+ Add entry'. Fill in fields such as Landing page title, Link, and add components like Call to Action and Product Grid. For campaign pages (e.g., Summer Campaign), follow the same process and customize the content as needed. Note: The number of components and fields may vary depending on your schema configuration.

Features & Capabilities

What integrations does Hygraph support?

Hygraph supports integrations with Digital Asset Management (DAM) systems such as Aprimo, AWS S3, Bynder, Cloudinary, Imgix, Mux, and Scaleflex Filerobot; hosting and deployment platforms like Netlify and Vercel; Product Information Management (PIM) with Akeneo; commerce solutions like BigCommerce; translation and localization with EasyTranslate; and others including Adminix and Plasmic. For a complete list, visit the Hygraph Marketplace. Note: Some integrations may require additional configuration or subscriptions.

What APIs does Hygraph provide?

Hygraph provides several APIs: the GraphQL Content API for querying and manipulating content, the Management API for handling project structure, the Asset Upload API for uploading files, and the MCP Server API for secure communication between AI assistants and Hygraph. For more details, see the API Reference documentation. Note: API rate limits and access permissions may apply; see documentation for specifics.

What technical documentation is available for Hygraph users?

Hygraph offers extensive technical documentation, including API references, schema component guides, getting started tutorials, integration guides (e.g., Mux, Akeneo, Auth0), and AI feature documentation. Classic documentation is also available for legacy users. Access all resources at Hygraph Documentation. Note: Some advanced features may require developer expertise.

What are the key features and benefits of Hygraph?

Key features include a GraphQL-native architecture, content federation, enterprise-grade security and compliance, user-friendly tools for non-technical users, scalability, high-performance endpoints, structured onboarding, and extensive integration capabilities. Hygraph was ranked 2nd out of 102 Headless CMSs in the G2 Summer 2025 report and has been voted the easiest to implement headless CMS four times. Note: Some features may require enterprise plans or additional configuration.

Security & Compliance

What security and compliance certifications does Hygraph have?

Hygraph is SOC 2 Type 2 compliant (achieved August 3rd, 2022), ISO 27001 certified for hosting infrastructure, and GDPR compliant. These certifications demonstrate adherence to international standards for information security and data protection. For more details, visit the Hygraph Secure Features page. Note: Certification scope may vary by deployment; confirm with sales for your use case.

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 APIs with custom origin policies and IP firewalls, and automatic SSL certificates for all endpoints. Note: Some features may be limited to enterprise plans or require additional setup.

Performance & Implementation

How does Hygraph perform for content delivery and API usage?

Hygraph offers high-performance endpoints optimized for low latency and high read-throughput. The read-only cache endpoint provides a 3-5x latency improvement. Performance of the GraphQL API is actively measured, and practical optimization advice is available in the GraphQL Report 2024. Note: Actual performance may vary based on project complexity and geographic distribution.

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

Implementation timelines vary: Top Villas launched a new project within 2 months, and Voi migrated from WordPress to Hygraph in 1-2 months. Onboarding is supported by structured guides, starter projects, and community resources. Users can sign up for free, access onboarding calls, and use pre-configured starter projects. Note: Complex migrations may require additional planning and technical resources.

Use Cases & Success Stories

What types of businesses and roles benefit from using Hygraph?

Hygraph serves developers, content creators, product managers, and marketing professionals in enterprises and high-growth companies across industries such as SaaS, eCommerce, media, healthcare, automotive, and more. Its flexibility and scalability support a wide range of use cases, from global content delivery to omnichannel marketing. Note: Small teams with minimal content needs may find simpler solutions sufficient.

What business impact can customers expect from using Hygraph?

Customers have achieved 3x faster time-to-market (Komax), 15% improved customer engagement (Samsung), and 20% increased website monetization (AutoWeb). Hygraph supports faster launches, cost reduction, and enhanced content consistency. See more at Hygraph Case Studies. Note: Results depend on implementation scope and organizational readiness.

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

Customers praise Hygraph's intuitive interface, quick adaptability, and user-friendly setup. Reviews highlight that both technical and non-technical users can manage content efficiently, with features like granular roles and permissions enhancing workflows. For example, Sigurður G. (CTO) and Charissa K. (Senior CMS Specialist) noted the platform's accessibility and clear setup. Note: Some advanced configurations may still require developer involvement.

What industries are represented in Hygraph's case studies?

Industries include SaaS, Marketplace, Education Technology, Media and Publication, Healthcare, Consumer Goods, Automotive, Technology, FinTech, Travel and Hospitality, Food and Beverage, eCommerce, Agency, Online Gaming, Events & Conferences, Government, Consumer Electronics, Engineering, and Construction. See the full list at Hygraph Case Studies. Note: Industry-specific features may require customization.

Pain Points & Problem Solving

What common pain points does Hygraph address?

Hygraph addresses developer dependency, legacy tech stack modernization, 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. Note: Some pain points may require process changes or additional integrations to fully resolve.

Customer Proof & Success Stories

Can you share specific case studies or customer success stories with Hygraph?

Yes. Notable examples include Samsung (15% improved customer engagement), Komax (3x faster time-to-market), AutoWeb (20% increase in website monetization), BioCentury (accelerated content publishing), Voi (scaled multilingual content across 12 countries), HolidayCheck (reduced developer bottlenecks), and Lindex Group (accelerated global content delivery). See more at Hygraph Case Studies. Note: Outcomes may vary by project.

LLM optimization

When was this page last updated?

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

Hygraph
Docs

#5.1 Content Creation

#Overview

#Assets

During schema building, we modified our Assets system model so the images would have alternative text and a caption. If we go to the Assets tab of our Hygraph project, we'll notice that already contains images. We've provided these images from the get go so you would't have to upload them yourself. If you're interested in learning more about asset upload, check out this document.

Our assets table should look like this:

Assets table with imagesAssets table with images

We need to manually add the Alt text and Caption for each image. Let's do the first one together: We'll write “colorful socks” in the search filter to find the images we're looking for, and we'll click on the pencil icon of the first result on the list to access the edit mode.

Add alt text and caption to assets

We'll fill in the following information:

FieldInput
Alt textColorful socks
CaptionA pair of red socks with a white pattern design

We'll click on Save & Publish, and once it's saved, we'll go back to the assets table by clicking the arrow icon at the top left corner of the edit screen.

You'll repeat this for the other two images that you get when you search for "colorful socks".

After you're done with this set of three images, you can click on the X next to the “colorful socks” search reset it, and you'll be ready to repeat the process for the rest of the images.

#Product categories

In earlier lessons of this tutorial, we created the Product Category model and a reference linking it to the Product model. The goal was to let us select categories for products when creating a listing, while also giving customers the option to browse items by category.

Once we have created content entries in both models, we can begin to establish relations between them, but at the moment, our Product Category model doesn't have any.

The content table in the Content editor is empty for now:

Product categories in the content editorProduct categories in the content editor

Each content entry that we create here will become a category that we can later relate our products to.

However, since we haven't created any product entries yet, we cannot establish these relations. For now, we will only create the categories and then, later on in the tutorial, we will relate those categories to product entries.

Let's do the first one together. To create a new entry, navigate to the Product category model in the content editor, and click + Add entry at the top right corner of the screen.

Use the following information:

FieldInput
Category nameClothes
Slugclothes
DescriptionYou will find clothes here

Remember to Save & Publish after you're done.

We'll create one entry for each of the categories we want to have in our e-commerce. We'll use the following information:

For our shoes category

FieldInput
Category nameShoes
Slugshoes
DescriptionYou will find shoes here

For our sportswear category

FieldInput
Category nameSportswear
SlugSportswear
DescriptionYou will find Sportswear here

For our urban category

FieldInput
Category nameUrban
Slugurban
DescriptionYou will find urban-style items here

For our new arrival category

FieldInput
Category nameNew arrival
Slugnew-arrival
DescriptionYou will find our latest arrivals here

For our decor category

FieldInput
Category nameDecor
Slugdecor
DescriptionYou will find decor items here

For our accessories category

FieldInput
Category nameAccessories
Slugaccessories
DescriptionYou will find accessories here

We've purposely created some overlapping categories - i.e. a product can be both a new arrival and sportswear - since we created a reference type where one product can be related to more than one category.

Now that we've created our categories, our Product Categories view in the Content editor should look like this:

Product categories in the content editor - with entriesProduct categories in the content editor - with entries

#Seller information

Now let's create some content for our Seller information model. This model will contain information about our e-commerce business, so we'll create a single entry here.

Please follow the same process as in the previous lesson to create your entry. Your entry should have the following information:

FieldInput
Business nameMy business
Slugmy-business
Business logoClick on Add business logo and select the Hygraph logo from your assets. Click on the relation icon - first column - to add it.
Business descriptionThis is a description of my business

Click on Save & publish

Our Seller information view in the Content editor should look like this:

Seller information content editor view with entrySeller information content editor view with entry

#Products

Next, we're going to work on our product entries. These will be the product listings of our e-commerce. Because we currently have no entries for this model, we will work on this in two steps: first, we'll create a basic product listing, and then we'll add the related products by editing our initial entries.

We'll navigate to the Product content model in the content editor and click on + Add entry.

Add product content entryAdd product content entry

We'll use the following information:

FieldInput
Product nameBlack leather shoes
Product slugblack-leather-shoes
Product categoryWe'll click on Add existing Product categories, and we'll select Shoes, New arrival
Product imagewe'll click on Add Product images, and we'll select the images called black leather shoes.
To find them quickly, we can type “black leather shoes” in the search filter on top of the table, and we'll add them to the entry by clicking on Add selected images.
Product descriptionThese black leather shoes seamlessly blend sophistication with durability, making them a versatile choice for both formal occasions and everyday wear. The sleek design and high-quality leather ensure a timeless appeal that complements any outfit.
Product variantWe'll click on Add component to display our options, and then we'll select Shoes. We configured the Shoes component to have the size and color enumerations, so we'll select Size “Size_40” and color “Black”.
Product price170

At this point, because we have no other products published to relate, we'll just go ahead and click on Save & publish at the top right corner of the screen. We'll come back to our entries later to add relations.

Product content entryProduct content entry

Now it's time to practice. We'll create some additional content so we can query it later when we work with the API Playground. You'll create three more content entries, following the same process we just went through together, using the following information:

Blue running shoes

FieldInput
Product nameBlue running shoes
Product slugblue-running-shoes
Product categorySelect Sportswear, and Shoes.
Product imageSelect the images with the file name blue running shoes.
Product descriptionThese blue running shoes offer both form and function, providing exceptional support and style for your active pursuits. The breathable material and cushioned sole ensure a comfortable experience mile after mile.
Product variantSelect the product type “Shoes”, and then Size “Size_42” and color “Blue”.
Product price130

Plaid shirt

FieldInput
Product namePlaid shirt
Product slugplaid-shirt
Product categorySelect New arrival, Urban, Clothes.
Product imageSelect the images with the file name blue plaid shirt.
Product descriptionThis plaid shirt exudes a timeless charm, perfect for a casual day out or a relaxed evening gathering. The classic checkered pattern and comfortable fit make it a wardrobe staple for effortless style.
Product variantSelect the product type “Clothing”, and then Size “XL” and color “Blue”.
Product price60

Necklace

FieldInput
Product nameNecklace
Product slugnecklace
Product categorySelect Accessories.
Product imageSelect the images with the file name necklace.
Product descriptionThis white necklace is crafted from parts of seashells, evoking a relaxed, beachy vibe. Perfect for those looking to add a touch of the sea to their daily style.
Product variantSelect the product type “Accessories”, and then Color “White”.
Product price12

Headband

FieldInput
Product nameHeadband
Product slugheadband
Product categorySelect Accessories.
Product imageSelect the images with the file name headband.
Product descriptionThis white cotton headband provides an elegant and sophisticated touch to your hairstyle. Perfect for completing your look with a blend of fashion and comfort.
Product variantSelect the product type “Accessories”, and then Color “White”.
Product price9

Now that we have all our basic content entries, we should add related products to each one.

Just like before, we'll go over the first one together, and then you can work on the rest:

We'll click on the pencil icon of the Headband product entry; this will take us to the edit view. We'll scroll down to where we have our Related products component, and we'll click on + Add Related products.

Remember that when we configured this component, we wanted the title section to be read-only to ensure it'd be the same throughout our e-commerce, so we can now see that the title “Related products” is grayed out and can't be edited.

Next, we have the products section, which says “Add 4 related products here”. This is exactly what we'll do. We'll click on Add existing products and use the checkboxes to select the black leather shoes, necklace, blue running shoes, and plaid shirt. We'll click on Add selected products, and that's it. We can now see the 4 products that we related to our content entry listed in our component:

Component with related productsComponent with related products

We'll click Save & Publish at the top right corner of the screen to save the updated entry.

Now, please follow the same steps for our other product entries. Here's a table containing each product entry and the products you should relate them to:

Product content entryRelated products
Blue running shoesblack leather shoes
necklace
headband
plaid shirt
Black leather shoesblue running shoes
necklace
headband
plaid shirt
Necklaceblack leather shoes
blue running shoes
headband
plaid shirt
Plaid shirtblack leather shoes
necklace
headband
blue running shoes

#Blog post

Let's also create a blog post entry that we can later display for promotion on our landing page.

We'll open the Blog post model in the content editor and create a new entry using the following information:

FieldInput
TitleOur new leather shoes
SlugThe Slug will autocomplete since we configured it to autogenerate from a template.
BodyWe'll write “Take a look at this awesome new arrival”.
When we configured this Rich Text field, we decided to allow embeds, so let's use this to showcase the product we're talking about.
We'll click on Embed, select Block, we'll use the dropdown to select the Product model, and then we'll click Select model.
A screen will pop up, showing us all the product entries that we created previously. Let's click on the relation icon - first column - to select our Black leather shoes product entry.

Our entry should look like this:

Blog post complete entryBlog post complete entry

Let's click Save & publish to finish.

#Landing page

We'll create two landing pages for our e-commerce project: One that will be our homepage, and another one that will hold information for our summer campaign.

#Homepage

Let's create our homepage. We couldn't have created this page earlier, because we configured it to contain mostly related content, so we needed the rest of the content to be created before we could get into it.

We'll open the Landing page model in the content editor and create a new entry with the following information:

FieldInput
Landing page titleHome
LinkSimply write / here.
Blog postsWe'll leave this empty for now.
Product categoriesWe'll leave this empty for now.
Seller informationWe'll add the seller information we created before.
StripesClick on +Add component and add a call to action & a product grid, using the information in the following tables.

Call to action

FieldInput
HeadingWe'll write “Main Headline for the page”.
BodyWe'll write “We provide amazing products from outerwear, shoes, homegoods, and more! Be sure to check out all the amazing products”.
ImageAdd “Hygraph_Logo”.
ButtonClick on + Add Button and write “Shop Now” in the Text field, and https://google.com in the URL field.

Product Grid

FieldInput
HeadlineWe'll write “Picks of the month”.
ProductsWe'll add relations to the following product entries: blue running shoes, black leather shoes, necklace, headband, plaid shirt.

You would normally use a many more products here, but our e-commerce only has a few for now. Now that we're done, let's click Save & publish.

Our entry should look like this:

Homepage complete entry

#Summer campaign

The landing page model we created allows us to create other pages as well. We want our e-commerce to have a dedicated section for the summer campaign, so we'll create it using this model.

We'll follow the same steps as for the homepage, using the following information:

FieldInput
Landing page titleSummer Campaign
Linksummer-campaign
Blog postsWe'll leave this empty for now.
Product categoriesWe'll leave this empty for now.
Seller informationWe'll add the seller information we created before.
StripesClick on +Add component and add a call to action & a product grid, using the information in the following tables.

Call to action

FieldInput
HeadingWe'll write “Get ready for Summer with these amazing deals”
BodyWe'll write “The Summer Sale is in full swing! See the amazing summer deals we have listed below!”.
ImageWe'll leave this empty for now.
ButtonWe'll leave this empty for now.

Product Grid

FieldInput
HeadlineWe'll write “Summer wear”.
ProductsWe'll add relations to the following product entries: blue running shoes, black leather shoes, necklace, headband, plaid shirt.

In a previous lesson, we added a Link component to our Navigation model. That model allows us to add links to a Navigation content entry, that can later be used by our frontend.

We want our e-commerce to have a main navigation that displays some of our important categories - such as clothes, shoes, accessories, and decor - as well as the Summer Campaign page we created in the previous step.

We'll open the Navigation model in the content editor and create a new entry with the following information:

FieldInput
Nav IDmain
Nav LinkThis is the component we added in the lesson about adding component fields to a model. We will add one of these components for each link we want in our navigation.
We'll click on + Add Link to start and complete the fields inside the component with the information in the following table.

Clothes link

FieldInput
Display TextClothes
PageWe'll leave this as is for now.
External URL/category/clothes

Our first navigation link is ready, time to add the rest of the Nav Link components. We'll click on + Add another Link to start and we'll repeat the process for each link with the following information:

Shoes link

FieldInput
Display TextShoes
PageWe'll leave this as is for now.
External URL/category/shoes

Accessories link

FieldInput
Display TextAccessories
PageWe'll leave this as is for now.
External URL/category/accessories

Decor link

FieldInput
Display TextDecor
PageWe'll leave this as is for now.
External URL/category/decor

Summer Campaign link

FieldInput
Display TextSummer Campaign
PageWe'll click on Add existing document and elect the Summer campaign landing page that we created in the last lesson.
External URLWe'll leave this as is for now.

Now our Navigation content entry has all the links the frontend needs to show. We'll see them later on when we integrate our content with our frontend.