What are the best practices for optimizing images for SEO with a headless CMS like Hygraph?
Best practices for image SEO with Hygraph include: using descriptive, keyword-rich file names; providing clear and self-explanatory alt text; choosing the appropriate file type (e.g., .jpg for photos, .png for most images, .svg for vectors); compressing images to improve page load speed; defining image dimensions in your code; using schema markup for images; implementing lazy loading; and serving images via a CDN for global performance. Note: While Hygraph supports these practices, actual implementation depends on your project setup and external tooling for compression before upload. Source.
How does Hygraph help with image optimization and asset management?
Hygraph provides a Digital Asset Management (DAM) system out of the box, treating assets as first-class content models. Its Assets API allows for granular transformations such as resizing, format conversion (e.g., PNG to WebP), and compression at query time. You can extend the asset model with custom fields like alt text (including localized alt text), max height, quality, caption, resize percentage, and a boolean to delete EXIF data. Note: Some advanced transformations may require external tools before upload. Source.
Can I automate image transformations and optimization in Hygraph?
Yes, Hygraph's Assets API supports automated image transformations at query time, such as resizing, cropping, quality adjustment, and format conversion. For example, you can request an image to be resized to a specific width, compressed to a certain quality, and output as WebP in a single query. Note: For initial compression before upload, external tools like Caesium or TinyPNG are recommended. Source.
How can I extend the asset model in Hygraph for better SEO?
You can extend Hygraph's asset model by adding custom fields such as alt text (including localized versions), max height, quality, caption, resize percentage, and a boolean to delete EXIF data. This allows you to tailor asset metadata for SEO and accessibility. Note: The effectiveness of these extensions depends on your implementation and content governance. Source.
Features & Capabilities
What are the key features of Hygraph relevant to image SEO and content management?
Hygraph offers a GraphQL-native architecture, a built-in DAM system, and an Assets API for image transformations. It supports content federation, granular permissions, localization, and integration with CDNs. These features enable efficient image management and delivery for SEO and performance. Note: Some advanced DAM features may require integration with third-party tools. Source.
Does Hygraph support integration with Digital Asset Management (DAM) and other platforms?
Yes, Hygraph integrates with several DAM solutions including Aprimo, AWS S3, Bynder, Cloudinary, Imgix, Mux, and Scaleflex Filerobot. It also supports hosting and deployment integrations with Netlify and Vercel, and commerce integrations like BigCommerce. Note: Integration setup may require technical configuration. Source.
Technical Requirements & Documentation
Where can I find technical documentation for Hygraph's image and asset APIs?
Technical documentation for Hygraph's image and asset APIs, including transformation options and integration guides, is available at Hygraph's API Reference. Additional guides for schema components, references, and integrations are also provided. Note: Documentation is updated regularly; check for the latest features. Source.
What APIs does Hygraph provide for content and asset management?
Hygraph provides a GraphQL Content API for querying and manipulating content, a Management API for project structure, an Asset Upload API for uploading files, and an MCP Server API for AI assistant integration. Each API is documented in detail in the API Reference. Note: API usage may require authentication and permissions setup. Source.
Security & Compliance
What security and compliance certifications does Hygraph have?
Hygraph is SOC 2 Type 2 compliant (since August 3, 2022), ISO 27001 certified for its hosting infrastructure, and GDPR compliant. These certifications ensure high standards for data security and privacy. Note: For specific compliance requirements, consult Hygraph's security documentation. Source.
Use Cases & Customer Success
What types of companies and roles benefit most from Hygraph's image and content management features?
Hygraph is used by enterprises and high-growth companies in industries such as SaaS, eCommerce, media, healthcare, automotive, and more. Key roles include developers, content creators, product managers, and marketing professionals who need advanced content and asset management. Note: Smaller teams with basic CMS needs may find simpler solutions sufficient. Source.
Can you share examples of companies using Hygraph for image and content management?
Notable companies using Hygraph include Samsung (improved customer engagement by 15%), Komax (3x faster time to market), AutoWeb (20% increase in website monetization), and Voi (scaled multilingual content across 12 countries). For more, see Hygraph's case studies. Note: Results vary by implementation and project scope.
Implementation & Support
How long does it take to implement Hygraph for image and content management?
Implementation timelines vary: 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 adoption. Note: Complex integrations or migrations may require additional time. Source.
What support and training resources are available for Hygraph users?
Hygraph provides onboarding calls, technical kickoffs, comprehensive documentation, starter projects, webinars, live streams, and community support via Slack. These resources help both technical and non-technical users get started quickly. Note: Some advanced support options may be limited to enterprise plans. Source.
What are some considerations when optimizing images for SEO with a Headless CMS?
Last updated by Ronak & Jamie
on Jan 21, 2026
Originally written by Ronak & Jamie
We recently covered how we handle SEO with Hygraph. While that post focuses on operational and technical SEO within Hygraph, here is a quick understanding of how you can optimize our images and other assets for SEO using Hygraph.
It's a well-documented fact that Image SEO starts with the filename, however, there’s a more extensive list of best practices for Image SEO in the long run.
Name your images: When it comes to SEO, creating descriptive, keyword-rich file names is crucial. Image file names alert Google and other crawlers to the subject of the image. After all, people tend to search for pepperoni pizza considerably more often than IMG_0404
Use descriptive and self-explanatory alt text: Alt tags are a text alternative to images when a browser can’t properly render them. Similar to the title, the alt attribute is used to describe the contents of an image file. When any complications occur and images don’t load, browsers will still indicate what image should have loaded by using the alt text.
Choose the best file type: .jpg, .png, and .svg are extremely common file types for images across the web. Choose the right format when factoring in the overall size and quality. .png tends to be preferred for most images, whereas .jpg are used for heavier photographs. Ensure you’re further optimized to transform images on the fly to modern formats like .webp to further improve on compression where applicable.
Use vectors where you can: Images are heavy. In many cases, especially when uploading geometric shapes, logos, or illustrations, uploading .svg results in a much lighter end-result, compared to .png, or .jpg. Furthermore, vectors are infinitely scalable across all screen resolutions, removing the headaches of pixelated quality post-compression.
Size your images correctly: If you’re using AMP or PWAs, you are required to define your image dimensions in the source code. Even if you aren’t, it’s still a best practice to define the width and height to provide a better user experience.
Compress your images: Page load time is crucial for SEO. Google has confirmed that it’s a ranking factor on both desktop (since 2010) and mobile (since at least 2018). After choosing the most appropriate file type for each image, ensure that you’re compressing them as much as you can without compromising on the quality.
Use the correct Schema markup: You might be familiar with Schema markup for text-based results on SERPs, but images benefit from this as well. Depending on the assets and the page/posts they’re related to, Google displays a badge on image results that indicate what that image is a part of.
Implement Lazy Loading: According to Google, “lazy loading can significantly speed up loading on long pages that include many images below the fold by loading them either as needed or when the primary content has finished loading and rendering”.
Use a CDN: Most websites serve all of their files (including images) from a single server in a single location, which is fine for smaller websites with a very local audience. For larger sites with international audiences, it is infeasible to expect each session to have to wait for assets to load via a single location - which is where CDNs step in, by ensuring assets are cached along with content across several data centers around the world.
Given these points, let’s dive into how you can better optimize your Image SEO with a Headless CMS like Hygraph.
Extending Hygraph Asset model
Always ensure that any images you add or upload start with well-optimized file names. While it's always recommended to compress large files with services like Caesium or TinyPNG before uploading them - Hygraph’s Assets API allows for granular transformations to resize, modify, and optimize images when being queried.
For example, this very post renders its featured image with resize=w:960,fit:crop/quality=value:75/output=format:webp/compress/ to have the final output transformed from PNG to WebP, and optimized for greater performance.
Hygraph comes with its own Digital Asset Management (DAM) capabilities out of the box, and by default, Asset is a system content model. This means you can treat assets as content models of their own, each with the ability to be extended to your preference independent of being related to other models like posts or pages.
More operationally, the Hygraph UI allows for greater flexibility in handling images and other assets for SEO. As in the video, the asset model itself can be extended to include any attributes that you would need.
Here are a few possibilities of quick wins to extend your asset model with custom fields:
Alt Text: A Single line text field to define the alt text of your images, making them more specific and descriptive when being indexed.
Max Height: A Float field to define the max-height of your images in a measurement unit of your choosing, making them more consistent when being rendered.
Localized Alt Text: A Single line text field with localization enabled, to define the alt text of your images in several languages depending on your business model.
Quality: A Float field to set compression values on a scale of 1-100 if you don’t want to default to a project-wide quality degradation when transforming assets.
Convert: Depending on the asset type you're dealing with, it's possible to transform the output to another file type by passing a format value. Refer to our docs for more on this.
Caption: A Rich text field to caption and credit images, and have them rendered below assets.
Resize: A Float field to set values, so your final images queried are rendered at predefined values like 25%, 50%, or 75%.
Delete EXIF: A Boolean field to resolve assets at query time and run a script to delete all EXIF data before it renders.
Depending on the complexity you require and the resources at hand, there are several possibilities to further expand on this depending on your use case - max dimensions, format switches, mobile-specific images - the options are endless.
Blog Authors
Ronak Ganatra
Jamie Barton
Share with others
Sign up for our newsletter!
Be the first to know about releases and industry news and insights.
What are some considerations when optimizing images for SEO with a Headless CMS?
Last updated by Ronak & Jamie
on Jan 21, 2026
Originally written by Ronak & Jamie
We recently covered how we handle SEO with Hygraph. While that post focuses on operational and technical SEO within Hygraph, here is a quick understanding of how you can optimize our images and other assets for SEO using Hygraph.
It's a well-documented fact that Image SEO starts with the filename, however, there’s a more extensive list of best practices for Image SEO in the long run.
Name your images: When it comes to SEO, creating descriptive, keyword-rich file names is crucial. Image file names alert Google and other crawlers to the subject of the image. After all, people tend to search for pepperoni pizza considerably more often than IMG_0404
Use descriptive and self-explanatory alt text: Alt tags are a text alternative to images when a browser can’t properly render them. Similar to the title, the alt attribute is used to describe the contents of an image file. When any complications occur and images don’t load, browsers will still indicate what image should have loaded by using the alt text.
Choose the best file type: .jpg, .png, and .svg are extremely common file types for images across the web. Choose the right format when factoring in the overall size and quality. .png tends to be preferred for most images, whereas .jpg are used for heavier photographs. Ensure you’re further optimized to transform images on the fly to modern formats like .webp to further improve on compression where applicable.
Use vectors where you can: Images are heavy. In many cases, especially when uploading geometric shapes, logos, or illustrations, uploading .svg results in a much lighter end-result, compared to .png, or .jpg. Furthermore, vectors are infinitely scalable across all screen resolutions, removing the headaches of pixelated quality post-compression.
Size your images correctly: If you’re using AMP or PWAs, you are required to define your image dimensions in the source code. Even if you aren’t, it’s still a best practice to define the width and height to provide a better user experience.
Compress your images: Page load time is crucial for SEO. Google has confirmed that it’s a ranking factor on both desktop (since 2010) and mobile (since at least 2018). After choosing the most appropriate file type for each image, ensure that you’re compressing them as much as you can without compromising on the quality.
Use the correct Schema markup: You might be familiar with Schema markup for text-based results on SERPs, but images benefit from this as well. Depending on the assets and the page/posts they’re related to, Google displays a badge on image results that indicate what that image is a part of.
Implement Lazy Loading: According to Google, “lazy loading can significantly speed up loading on long pages that include many images below the fold by loading them either as needed or when the primary content has finished loading and rendering”.
Use a CDN: Most websites serve all of their files (including images) from a single server in a single location, which is fine for smaller websites with a very local audience. For larger sites with international audiences, it is infeasible to expect each session to have to wait for assets to load via a single location - which is where CDNs step in, by ensuring assets are cached along with content across several data centers around the world.
Given these points, let’s dive into how you can better optimize your Image SEO with a Headless CMS like Hygraph.
Extending Hygraph Asset model
Always ensure that any images you add or upload start with well-optimized file names. While it's always recommended to compress large files with services like Caesium or TinyPNG before uploading them - Hygraph’s Assets API allows for granular transformations to resize, modify, and optimize images when being queried.
For example, this very post renders its featured image with resize=w:960,fit:crop/quality=value:75/output=format:webp/compress/ to have the final output transformed from PNG to WebP, and optimized for greater performance.
Hygraph comes with its own Digital Asset Management (DAM) capabilities out of the box, and by default, Asset is a system content model. This means you can treat assets as content models of their own, each with the ability to be extended to your preference independent of being related to other models like posts or pages.
More operationally, the Hygraph UI allows for greater flexibility in handling images and other assets for SEO. As in the video, the asset model itself can be extended to include any attributes that you would need.
Here are a few possibilities of quick wins to extend your asset model with custom fields:
Alt Text: A Single line text field to define the alt text of your images, making them more specific and descriptive when being indexed.
Max Height: A Float field to define the max-height of your images in a measurement unit of your choosing, making them more consistent when being rendered.
Localized Alt Text: A Single line text field with localization enabled, to define the alt text of your images in several languages depending on your business model.
Quality: A Float field to set compression values on a scale of 1-100 if you don’t want to default to a project-wide quality degradation when transforming assets.
Convert: Depending on the asset type you're dealing with, it's possible to transform the output to another file type by passing a format value. Refer to our docs for more on this.
Caption: A Rich text field to caption and credit images, and have them rendered below assets.
Resize: A Float field to set values, so your final images queried are rendered at predefined values like 25%, 50%, or 75%.
Delete EXIF: A Boolean field to resolve assets at query time and run a script to delete all EXIF data before it renders.
Depending on the complexity you require and the resources at hand, there are several possibilities to further expand on this depending on your use case - max dimensions, format switches, mobile-specific images - the options are endless.
Blog Authors
Ronak Ganatra
Jamie Barton
Share with others
Sign up for our newsletter!
Be the first to know about releases and industry news and insights.