Why should I migrate to the new Asset Management System?
Migrating to Hygraph's new Asset Management System is strongly recommended because the existing asset system will be deprecated by the start of next year. The new system offers a 10x increase in asset performance, faster asset uploads and delivery, support for SEO-friendly URLs, and more powerful asset transformations. Migrating ensures your project benefits from improved performance and availability. (Source)
What are the main benefits of the new Asset Management System?
The new Asset Management System provides several key benefits:
What is the timeline for migrating to the new asset system?
The existing asset system will be deprecated by the start of next year. You are encouraged to migrate as soon as possible using the provided migration tools. If your project is not migrated by the end of the year, Hygraph will automatically migrate it for you, with necessary disclaimers provided beforehand. (Source)
How do I migrate my project to the new asset system?
You can access migration tools from your project settings > environments in Hygraph Studio. For paid plans, clone your environment, test changes, and execute migration when ready. For the free hobby plan, edit your frontend code and migrate directly after making required changes. Detailed steps are available in the migration documentation. (Source)
What changes are required for the new asset system?
The new asset system introduces different asset handling, upload methods, URL structures, and transformation capabilities. Old asset URLs will no longer work after deprecation, and there will be no redirects. Hygraph will automatically replace old URLs in rich text and markdown fields, but you must manually update hardcoded URLs. You should also test your asset transformations and API upload processes. (Source)
Where can I find documentation and migration guides?
Comprehensive documentation and migration guides are available at Hygraph Asset Migration Documentation. These resources provide step-by-step instructions for both free and paid plans. (Source)
Features & Capabilities
Does Hygraph support SEO-friendly asset URLs?
Yes, the new Asset Management System supports SEO-friendly URLs, which can help improve your site's search engine visibility. (Source)
What performance improvements does the new asset system deliver?
The new asset system delivers a 10x increase in asset performance, including faster uploads and delivery, thanks to backend architecture enhancements. (Source)
Can I upload assets using GraphQL in Hygraph?
Yes, the new asset system introduces a new method for uploading assets via GraphQL, providing more flexibility for developers. (Source)
Pricing & Plans
Is the migration process different for free and paid plans?
Yes, for paid plans, you can clone your environment, test changes, and migrate when ready. For the free hobby plan, you must edit your frontend code and migrate directly after making all required changes. (Source)
Support & Implementation
What support is available during the migration process?
Hygraph provides support through Customer Success Managers (CSMs) and the Community Slack channel. You can also access detailed documentation and guides for migration. (Source)
Will Hygraph automatically migrate my project if I do not do it myself?
Yes, if your project is not migrated by the end of the year, Hygraph will automatically migrate it for you and provide necessary disclaimers before doing so. (Source)
Technical Requirements
What technical changes do I need to make for migration?
You need to update asset handling, upload methods, and URL structures in your code. Old URLs must be replaced with new ones, especially if they are hardcoded. Test all asset transformations and API upload processes to ensure compatibility. (Source)
Security & Compliance
What security and compliance certifications does Hygraph have?
Hygraph is SOC 2 Type 2 compliant, ISO 27001 certified, and GDPR compliant. These certifications ensure enterprise-grade security and data protection for all users. (Source)
General Product Information
Where can I find more information about Hygraph features and integrations?
You can explore Hygraph's features and integrations at Hygraph Features and Hygraph Integrations. These pages provide details on capabilities, supported platforms, and third-party integrations.
Our new Asset Management System is now available for existing projects
Enhance performance and availability by switching to our new Asset Management System. We strongly recommend migrating as soon as possible using our migration tools, as the existing asset system will be deprecated by the start of next year.
Written by Shahan
on Sep 30, 2024
We released our new Asset Management System earlier this year for improved performance and reliability. This was available for all new projects created since March 2024.
The new asset system is available for existing projects as well, and you can now migrate using our tools.
We are gradually rolling out our migration tools, and you will receive an email notification once they become available. You can access the migration tools from your project settings > environments.
The process for paid projects involves cloning your existing environment to a migration environment and testing for any breaking changes. Once everything seems fine, you can execute the migration, and we will handle the rest.
For the hobby plan, you will have to make changes to your code and directly migrate once complete.
Note: We will be deprecating our existing asset system by the start of next year and recommend you switch as soon as possible.
Our new Asset Management System has been developed with a clear focus on improving performance and availability. The changes we’ve implemented in the backend architecture have resulted in a 10x increase in asset performance.
We have a new workflow within the app and detailed documentation available to ease your migration process. You can access the migration tools from your project settings > environments.
The migration tools are only available in Hygraph Studio. To migrate, please switch your project to the new Hygraph Studio from your project settings.
The migration process differs depending on whether you are on a free or paid plan.
Paid Plans
If you are on a paid plan, you can clone your existing environments to a migration environment, make relevant changes to your frontend code, and test the changes in this new environment.
Once you have ensured everything works fine, you can migrate your master environment (or other environments) by selecting start migration.
Community Plan
If you are on a free hobby plan, you’ll have to edit your frontend code and directly migrate your master environment to the new asset system once you have made all the required changes.
The new asset system has a different approach to asset handling, upload methods, URL structures, and transformation capabilities.
The new asset system serves from a different URL; there will be no redirects, and the old URLs will no longer work after we deprecate the old asset system.
To ease the process, we will automatically replace the old URLs contained within rich text and markdown fields. This means that we will automatically handle assets embedded in your content.
However, you need to replace the old URLs with the new ones in places where they are hardcoded and test them out.
We also have a new process for uploading assets via the API, and the exact transformations supported in the new system differ.
Here are a few examples of scenarios where you would need to test and make changes:
#Timelines and deprecation of the existing asset system
We plan to deprecate our existing asset system by the end of this year and offer the next few months as a time to carry out the migration yourselves.
For projects that are not migrated by the end of the year, we will automatically migrate them for you, providing the necessary disclaimers before doing so.
As always, feel free to reach out to us for any questions through your CSMs or our Community Slack channel.
Blog Author
Shahan Syed
Shahan is the Product Marketing Manager at Hygraph. Living in Pakistan, he loves to spend time exploring places, pencil sketching, reading, and watching science fiction and K-dramas.
Share with others
Sign up for our newsletter!
Be the first to know about releases and industry news and insights.