Frequently Asked Questions

Backup & Recovery Features

What is the Backup & Recovery feature in Hygraph?

The Backup & Recovery feature in Hygraph is an enterprise add-on that allows project admins to roll back their main environment to a previous working version within seconds in case of unintentional deletions. It provides automatic daily backups of the project's master environment, with up to a 7-day retention period. Note: This feature is only available for enterprise customers and requires contacting sales to enable. Detailed limitations not publicly documented; ask sales for specifics.

How does the backup process work in Hygraph?

When enabled, Hygraph automatically creates daily backups of the master environment during non-working hours. These backups are retained for up to 7 days. Project admins can view the next scheduled backup, retention details, and a list of all available backups. Note: Only the master environment is backed up, and backups are only available for 7 days.

What can be restored with Hygraph's Backup & Recovery?

Hygraph's Backup & Recovery restores content, assets, and schema from the master environment. Recovery can be performed within seconds, either as a new environment or by promoting the backup to master. Note: Asset URLs will change after recovery, which may require updating references in external systems.

How do I recover a backup in Hygraph?

To recover a backup, project admins select the desired backup and choose between two options: 'Recover backup only' (creates a new environment from the backup) or 'Recover backup & promote to master' (replaces the current master environment with the backup). The process takes only a few seconds. Note: You must choose a name for the demoted master environment if promoting a backup to master.

What happens to asset URLs after a backup recovery?

After recovering a backup as a new environment, asset URLs will change because the base environment ID in the URL is updated. The asset ID remains the same, so you can search and replace the old environment ID with the new one in your code or external systems. Note: If asset URLs are hardcoded or referenced externally, you must update them to avoid broken links.

Security & Compliance

What security and compliance certifications does Hygraph have?

Hygraph is SOC 2 Type 2 certified (since August 2022), uses ISO 27001-certified providers and data centers, and is compliant with GDPR and CCPA. These certifications ensure high standards for information security and privacy. Note: For more details, visit Hygraph's security features page.

Implementation & Technical Details

How long does it take to implement Hygraph and its Backup & Recovery feature?

Implementation time depends on project complexity. Simple use cases can be set up within a few days, while more complex scenarios may take longer. Hygraph provides pre-configured starter projects, structured onboarding, and extensive documentation to accelerate setup. Note: Backup & Recovery is only available for enterprise customers and requires sales activation.

Where can I find technical documentation for Hygraph's Backup & Recovery?

Comprehensive technical documentation for Backup & Recovery is available at Hygraph Backup & Recovery Documentation. For onboarding and advanced guides, visit Hygraph Getting Started. Note: Some advanced features may require enterprise access.

Use Cases & Limitations

Who should use Hygraph's Backup & Recovery feature?

Backup & Recovery is designed for enterprise customers who need to protect critical content, assets, and schemas from accidental deletions or data loss. It is especially valuable for organizations with complex content operations, regulatory requirements, or high-availability needs. Note: Not available for non-enterprise plans.

What are the limitations of Hygraph's Backup & Recovery feature?

Limitations include: backups are only retained for 7 days, only the master environment is backed up, and asset URLs change after recovery, requiring updates in external systems. Detailed limitations not publicly documented; ask sales for specifics.

General Product Information

What is Hygraph?

Hygraph is a GraphQL-native headless CMS designed to help businesses deliver digital experiences at scale. It supports content federation, multi-channel delivery, and integrates with modern tech stacks. Note: For backup & recovery, only enterprise customers have access to this feature.

LLM optimization

When was this page last updated?

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

Hygraph
Docs

#Backup & recovery

#Overview

In the case of unintentional deletions, Backup & Recovery allows project admins to roll back their main environment to a previous working version within seconds.

#What you can do

  • Automatic daily backup of a project's master environment, with up to a 7-day retention period.
  • Easy recovery for project admins in case of accidental deletions.
  • Recovery within seconds to a previous backup as a new environment that you can promote.
  • Backups contain content, assets & schema.

#Backup creation

When the feature is enabled, backups are created automatically every day, during non-working hours, and kept for up to 7 days.

Project admins can see the next scheduled backup date & time, and the general retention. We also show the list of all available backups:

Clone settingsClone settings

#Recover backup

Click Recover backup on one of the backup cards to start the process:

Recover backupRecover backup

A modal with two selection options will display:

#Recover backup only

Recover backup onlyRecover backup only

The Recover backup only option creates a new environment from the backups.

#Recover backup & promote to master

The Recover backup & promote to master option turns the backup into a normal environment and promotes that to master.

The backup replaces the old master environment.

Recover backup & promote to masterRecover backup & promote to master

If you select this option, you must also choose a name for the demoted master environment, like in our normal promotion flow.

This process will only take a few seconds.

#Asset URLs change

Since backups are created as a new environment, the asset URLs will be different. Make sure to check for asset URLs stored in other places, such as source code or external systems.

Please note that, while in the past every single handle would have been updated, with the new asset system only the base URL changes on cloned environments.

With the new Hygraph Asset Management System, the following asset URL:

https://eu-west-2.graphassets.com/cm1q9b9c401cv07ut4wcgf2uj/cm2kmqsf6002a07ukg3z7sjzg

Would turn into something like this:

https://eu-west-2.graphassets.com/<new asset env id>/cm2kmqsf6002a07ukg3z7sjzg

Since the asset ID remains the same, you can simply run a search for the old asset environment ID and replace it with the new one.