Frequently Asked Questions

Content Stages & Workflow Management

What are the default content stages in Hygraph?

Hygraph provides two system content stages out of the box: DRAFT and PUBLISHED. The DRAFT stage allows users to add and edit content without affecting live content, while promoting content to the PUBLISHED stage makes it available for consumption. These system stages cannot be edited or deleted. Note: If you need additional workflow steps, you must use custom content stages, which are only available on paid plans.

Can I create custom content stages in Hygraph?

Yes, you can create custom content stages in Hygraph if your project is on a paid plan. Navigate to Project settings > General > Content stages to add, edit, or delete custom stages. The Community Plan does not support custom content stages; you will need to upgrade to access this feature. Note: The number of custom stages you can add depends on your plan limits.

How do I add, edit, or delete a custom content stage?

To add a custom content stage, go to Project settings > General > Content stages and click + Add stage. Provide a display name, select a label color, and optionally add a description. To edit, click the Edit button on the desired stage card, update the details, and save. To delete, click Delete on the stage card, confirm by typing the stage name, and proceed. Note: Only available on paid plans; deletion is irreversible.

What are some common use cases for custom content stages?

Custom content stages are used to model complex content workflows, such as adding QA, Legal Review, or Translation stages before publishing. This allows teams to manage approvals and quality checks tailored to their organizational needs. Note: Custom stages are not available on the Community Plan; upgrading is required for advanced workflows.

Features & Capabilities

What integrations does Hygraph support?

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

Does Hygraph provide an API for managing content stages?

Yes, Hygraph offers a GraphQL Content API for querying and manipulating content, including content stages. There is also a Management API for handling project structure, and an Asset Upload API for managing assets. For details, see the API Reference documentation. Note: API access may be subject to plan limitations and permissions.

What technical documentation is available for content stages and workflows?

Hygraph provides comprehensive documentation on configuring content stages, content workflows, API usage, schema components, and integrations. Key resources include the Content Stages Guide, Content Workflows Guide, and API Reference. Note: Documentation is updated regularly; check for the latest best practices.

Pricing & Plans

Are custom content stages available on all Hygraph plans?

No, custom content stages are only available on paid Hygraph plans. The Community Plan is limited to the default DRAFT and PUBLISHED stages. To add stages like QA or Review, you must upgrade your plan. For details, see the Hygraph Pricing page. Note: Plan limits may restrict the number of custom stages you can create.

Security & Compliance

What security and compliance certifications does Hygraph hold?

Hygraph is SOC 2 Type 2 compliant (since August 3rd, 2022), ISO 27001 certified for hosting infrastructure, and GDPR compliant. These certifications ensure high standards for information security and data privacy. For more details, visit the Hygraph Secure Features page. Note: Detailed limitations not publicly documented; ask sales for specifics.

Implementation & Onboarding

How long does it take to implement Hygraph and configure content stages?

Implementation timelines vary 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 accelerate setup. Note: Complex workflows may require additional configuration time.

Customer Feedback & Use Cases

What feedback have customers shared about Hygraph's workflow and content stage features?

Customers highlight Hygraph's intuitive interface and ease of use for both technical and non-technical users. For example, Sigurður G. (CTO) praised the UI as intuitive, and Charissa K. (Senior CMS Specialist) noted the platform's clear setup and versatility in adding new content components. Note: Some advanced workflow features require a paid plan.

Limitations & Plan Restrictions

What are the limitations of content stages on the Community Plan?

The Community Plan only allows use of the default DRAFT and PUBLISHED stages. Custom stages (e.g., QA, Review) are not available. To unlock advanced workflow capabilities, you must upgrade to a paid plan. Note: Plan limits may also restrict the number of custom stages.

LLM optimization

When was this page last updated?

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

Hygraph
Docs

#Configuring content stages

#Overview

Hygraph offers two OOTB system content stages, plus the ability to create custom content stages depending on your plan.

This document provides information on how system content stages work, and how to work with custom stages.

#What you can do

You can use the system content stages OOTB, or customize your workflow by creating custom content stages.

#System content stages

Hygraph has two system content stages, DRAFT and PUBLISHED. These content stages cannot be edited or deleted.

DRAFT allows people to add and edit content without affecting published content. Promoting the content to the PUBLISHED stage, pushes it live, which means it can be consumed by others.

#Custom content stages

#Creating custom content stages

To create your own content stages, navigate to Project settings > General > Content stages.

The default screen shows the DRAFT and PUBLISHED system stages, and offers the option to upgrade your plan if you want to configure any additional stages.

Content Stages Project SettingsContent Stages Project Settings

The QA stage card is grayed out as it's not part of the Community Plan. Clicking on the Upgrade to add this content stage link at the bottom of this card displays a popup where you can select the best plan for your project.

QA StageQA Stage

You can also change the order of your destination content stages by clicking on the six dots handle, located to the left of each configured stage card, and dragging.

If you haven't reached the limit of stages for your plan, then you will simply be provided with the option of adding a new stage.

+ Add stage+ Add stage

If your project allows custom content stages, clicking on + Add stage displays a screen that requires you to provide a Display name and select a label color. You can optionally add a description. The API ID field will be autocompleted as you write the display name.

+ Add stage+ Add stage

After typing in all the necessary information, you can click Add to create the content stage.

#Editing custom content stages

To edit a custom content stage, navigate to Project settings > General > Content stages in your Hygraph project, and click on the Edit button on the card of the content stage you want to edit.

Edit stageEdit stage

The content stage details page will display. Edit the information you need to change, then click Update to save your changes.

Edit stage - details screenEdit stage - details screen

#Deleting custom content stages

To delete a custom content stage, navigate to Project settings > General > Content stages in your Hygraph project, and click Delete on the card of the content stage you want to delete.

Delete stageDelete stage

A confirmation screen displays, where you need to type in the stage name, then click Delete stage to proceed.

Delete stage - confirmation screenDelete stage - confirmation screen