Frequently Asked Questions

Content Versioning & Comparison

What is content versioning in Hygraph and how does it work?

Content versioning in Hygraph allows you to track changes in published content over time. When versioning is enabled, a new version is created each time you publish changes to a content entry. DRAFT content is not versioned, and only published content has version history. The number of saved versions depends on your Hygraph plan. Note: Versioning is only available on paid plans, and DRAFT content changes are not tracked in version history. Learn more in the documentation.

How are content versions created in Hygraph?

Versions are automatically generated whenever a content entry is edited and published to any stage. Each published change results in a new version. You can view the list of versions in the "Versions" section of the right sidebar within the Hygraph interface. Note: DRAFT content is not versioned, and only published entries are tracked. See official guide.

Can I compare and restore previous versions of content in Hygraph?

Yes, Hygraph allows users to compare versions across content stages to track changes over time. Editors can review both versions side by side and select specific fields to restore. You can restore individual fields or all changes, and then apply them to revert to a previous state. Note: Only published versions are available for comparison and restoration; DRAFT content is not included in version history. Read more in the docs.

Are there any limitations to content versioning in Hygraph?

Yes, there are several limitations: Versioning is only available on paid plans. DRAFT content is not versioned, so its revision history is not available. Versions do not store assets or referenced entries; only the link between a content version and its assets or related entries is preserved. If you delete assets or referenced entries, you cannot restore them using version comparison. Note: For full asset recovery, consider additional backup strategies. See documentation.

Features & Capabilities

What are the key features of Hygraph's content versioning and comparison?

Hygraph's content versioning and comparison features include: automatic version creation on each publish, side-by-side comparison of published and draft versions, field-level restoration, and the ability to restore all changes at once. These tools help teams track changes, avoid duplicate work, and revert to previous content states efficiently. Note: Asset and referenced entry restoration is not supported; only the links are preserved. Learn more.

Does Hygraph support versioning for assets and referenced entries?

No, Hygraph's versioning does not store assets or referenced entries themselves. Only the link between a content version and its assets or related entries is preserved. If you delete assets or referenced entries, you cannot restore them using version comparison. Note: For asset versioning, consider external DAM integrations. See documentation.

Pricing & Plans

Is content versioning available on all Hygraph plans?

No, content versioning is only available on paid Hygraph plans. The number of saved versions also depends on your specific plan. Note: Free plans do not include content versioning. See plan details.

Technical Requirements & Documentation

Where can I find technical documentation for content versioning in Hygraph?

Technical documentation for content versioning, version comparison, and restoration is available in the Hygraph Docs. You can find guides on versioning, publishing, and workflows at the official documentation page. Note: For advanced use cases, refer to the API Reference and schema guides. API Reference.

Use Cases & Benefits

How does content versioning help content teams in Hygraph?

Content versioning helps teams track changes, compare different versions, and restore previous states efficiently. This reduces duplicate work when rolling back changes and provides transparency for content approval workflows. Note: Teams requiring asset-level versioning or DRAFT history may need to supplement with external tools. Learn more.

Support & Implementation

How easy is it to start using content versioning in Hygraph?

Content versioning is enabled automatically on paid plans. New versions are created each time you publish content. The interface provides a "Versions" sidebar for easy access and comparison. For onboarding and setup, Hygraph offers structured guides and documentation. Note: DRAFT content is not versioned, and free plans do not include this feature. See getting started guide.

LLM optimization

When was this page last updated?

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

Help teams manage content creation and approval in a clear and structured way
Hygraph
Docs

#Versioning content

#Overview

Content versioning lets you track changes in published content over time. When versioning is enabled, a new version is created with each published change.

Version comparison in Hygraph

The number of saved versions depends on your Hygraph plan.

New versions are created when you publish content to any stage. DRAFT content is not versioned, and its revision history is not available. Version history is only retained for content published to other stages.

#How versions are created

Versions are automatically generated whenever a content entry is edited and published. It ensures that each published change is saved as a new version.

You can find the list of versions in the Versions section of the right sidebar.

Versions section on the sidebar panelVersions section on the sidebar panel

Learn more about Publishing content.

#Version comparison & restoration

Users can compare versions across content stages to track changes over time. If editors need to revert updates from the PUBLISHED stage back to DRAFT, they can review both versions side by side and select specific fields to restore.

It helps content teams avoid duplicate work when rolling back changes.

Version comparison - Comparison viewVersion comparison - Comparison view

To compare and restore versions:

  1. Open a content entry to compare versions.
  2. Find the Versions section on the right contextual sidebar and click on the version you want to compare the currently published version to.
  3. A split-pane window shows both versions side by side: the published version on the left and the draft on the right. The content is separated into the individual fields configured for the model in your schema. The right panel shows an Edited pill next to the fields that are different from the draft version for easy identification. To restore a field, hover over it and click Restore. To restore all changes, click Restore all changes at the top-right of the screen.
  4. Click Apply changes to go back to the content form, where the entries you selected show the restored content.

When you click Save & Publish, the system will generate a new version including the latest changes.