The Asset model in Hygraph is included with every project and is used to manage digital files such as images, audio files, zip files, and more. It can be customized with different field types, is localized by default, and cannot be deleted. The Asset type also extends Hygraph's system fields for enhanced metadata and management. Learn more.
While assets are most commonly used for photos, Hygraph supports any file type, including images, audio files, zip files, PDFs, and more. These files are managed within the Digital Asset Manager and served via a global CDN. Source.
Hygraph projects created after February 2024 use the new Hygraph Asset Management system, while older projects use the Legacy asset system. To check which system your project uses, look at the asset upload popup in the UI or navigate to Project Settings > Endpoints and look for the Assets section. The UI will display different screens depending on the system in use. Learn more.
The new Hygraph Asset Management system offers a 10x increase in asset performance, faster asset uploads and delivery, and support for SEO-friendly URLs. It is designed for improved performance and availability, ensuring a faster and more intuitive user experience. Source.
Hygraph provides detailed documentation for each asset operation:
updateAsset mutation.deleteAsset mutation.publishAsset and unpublishAsset mutations.Yes, assets in Hygraph are localized by default. You can learn more about asset localization in the localized assets documentation.
Yes, assets also count against your content entry limit in Hygraph. Source.
To add assets, click the Assets button in the editor to open the Select Asset screen. You can select from available assets or upload a new one by clicking the Upload button and following the step-by-step guide. Learn more.
You can apply various transformations to assets, such as resizing, cropping, and format changes. Detailed information is available in the Transformations section of the documentation.
Migrating to the new asset system provides a 10x increase in asset performance, faster uploads and delivery, and SEO-friendly URLs. The new system is designed for improved performance and availability. Source.
Assets in Hygraph are digital files uploaded to the Digital Asset Manager (DAM), such as images, PDFs, or videos. These assets are stored in Hygraph and delivered via a global content delivery network (CDN) for fast and reliable access. Source.
The new Asset Management System in Hygraph is focused on improving performance and availability, ensuring users experience faster and more reliable asset management. Source.
The new asset grid view allows users to browse and select assets quickly, enhancing the user experience and efficiency of asset management. Source.
You can find comprehensive documentation for working with assets, including API references and guides, at Hygraph Assets API Reference. This includes information on fetching, referencing, transforming, uploading, updating, deleting, publishing, localizing, and embedding assets.
The Asset manager in Hygraph provides tools for working with assets, uploading new files, and creating asset entries. It is accessible through the Hygraph editor interface. Source.
Hygraph emphasizes optimized content and asset delivery performance, which directly impacts user experience, engagement, and search engine rankings. The platform ensures rapid content distribution and responsiveness, reducing bounce rates and increasing conversions. Learn more.
Content is increasingly considered an asset because it is not just used for marketing, but is also sold directly to customers, making its management and delivery critical for business success. Source.
The Asset model is included with every project, can be modified with custom Field Types, and are localized by default, but cannot be deleted.
While most commonly used for photos, can support any file type including audio files, zip files, and more.
The Asset type extends the system fields.
Here are some links that might help you:
| Document name | Description |
|---|---|
| Fetching assets | Learn about the 4 query types that Hygraph automatically creates for every asset. |
| Referencing assets | Learn how to query assets in relation to a model in your schema. |
| Transformations | Learn about asset transformations. |
| Uploading assets | Learn how to upload assets by file and by remote URL. |
| Updating assets | Learn how to use the updateAsset mutation. |
| Deleting assets | Learn how to delete assets using the deleteAsset mutation. |
| Publishing assets | Learn how to use the publishAsset and unpublishAsset mutations. |
| Localized assets | Learn about asset localization. |
| Embedded types | Learn how to ember assets into Rich Text fields. |
At the moment, Hygraph projects can use one of two asset systems. Projects created after February 2024 will use the new Hygraph Asset Management system, while projects that are older than that will use the Legacy asset system.
If your project is a clone of an older project, it will use the legacy asset system.
To learn what system your project uses, check the asset upload popup in the UI.
UI asset upload
If your project shows this, you are using the legacy asset system:
UI - Legacy Asset system
If your project shows this, you are using the Hygraph Asset Management system:
UI - Hygraph Asset Management system
Another way to quickly see which asset system your project uses is to navigate to Project Settings > Endpoints, and look for the Assets section.
If you see this, your project uses the new Hygraph Asset Management system:
Hygraph Asset Management system
If you see this, your project uses the Legacy Asset system:
Legacy Asset system
While both systems are available, our documentation will provide information on how to work with each. You will find this in our API Reference for Assets in the transformations, asset upload, and localization documents.
Simply identify the system your project uses and proceed with that documentation.