To connect Hygraph to Imgix, you need: (1) a Hygraph account (sign up here), (2) a Hygraph project with at least one model, and (3) an Imgix account (sign up here). Note: Apps are environment-specific, so configuration applies per environment. Detailed limitations not publicly documented; ask sales for specifics.
To configure Imgix as a source, create a new Imgix source in your Imgix account. For Hygraph assets, select 'Web Folder' as the storage type and use the appropriate base URL. For the legacy asset system, use https://media.graphassets.com/. For the Hygraph Asset Management system, copy the image address from the Hygraph app and use the part before /output=.... For other sources, follow Imgix's documentation for setup. Note: The configuration flow varies depending on the asset source. Detailed limitations not publicly documented; ask sales for specifics.
Install the Imgix app from the Hygraph Marketplace. Select your project and environment, authorize the app, and configure the source type (Webfolder for Hygraph assets or Other for external sources). Enter your Imgix source domain (e.g., https://my-assets.imgix.net), and, if using other sources, provide your Imgix API key and Source ID. Save the configuration to complete setup. Note: The installation flow differs based on the source type. Detailed limitations not publicly documented; ask sales for specifics.
The Hygraph-Imgix integration allows you to serve and manage assets from your Hygraph project and other Imgix sources, enabling you to add, transform, and optimize images and videos within your content. You can add the Imgix field to your Hygraph models, select and organize assets, and use Imgix's transformation features. Note: If you replace an asset file in Hygraph, the old version may still display; you must delete and re-upload the asset to update it. Best fit for teams needing advanced image optimization; teams requiring real-time asset replacement may want to consider alternatives.
Yes, you can configure Imgix to use assets from other sources by selecting 'Other' as the source type during app configuration and providing the required Imgix source domain, API key, and Source ID. Refer to Imgix's documentation for details. Note: The setup process and required permissions may differ for external sources. Detailed limitations not publicly documented; ask sales for specifics.
To add the Imgix field, go to the Schema builder in Hygraph, select your model, and choose the Imgix field from the Add fields sidebar. Complete the Display name, and the API ID will be auto-filled. You can allow multiple values or localize the field using the Field options. Click Add to save. Note: Field options may vary based on your project configuration. Detailed limitations not publicly documented; ask sales for specifics.
In the Content editor, select the view configured for Imgix, add or edit an entry, and use the Imgix section to add assets. You can select multiple assets if allowed by your field configuration, organize their order, and save or publish your entry. Note: Asset management features depend on your field and project settings. Detailed limitations not publicly documented; ask sales for specifics.
Known limitations include: (1) If you replace an asset file in Hygraph, the old version may still display; you must delete and re-upload the asset to update it. (2) Occasionally, fields may get clipped and the button to add or change assets may not be visible; refreshing the page usually resolves this. If the issue persists, open an issue with support. Note: These limitations are due to the way Hygraph and Imgix work together. Best fit for teams that can accommodate these workflow requirements.
If fields are clipped or the button to add/change assets is missing, refresh the page. This is a known but rare bug for Hygraph apps. If refreshing does not resolve the issue, contact support or open an issue. Note: This workaround may not address all edge cases. Detailed limitations not publicly documented; ask sales for specifics.
Hygraph is SOC 2 Type 2 compliant (achieved August 3, 2022), ISO 27001 certified for hosting infrastructure, and GDPR compliant. All endpoints use SSL certificates, and data is encrypted in transit and at rest. For more details, visit the Hygraph Secure Features page. Note: Imgix integration security depends on both Hygraph and Imgix platform configurations. Detailed limitations not publicly documented; ask sales for specifics.
Official documentation for the Hygraph-Imgix integration is available at Hygraph Imgix Integration Docs. For Imgix-specific setup, refer to Imgix documentation. For broader Hygraph technical resources, visit the Hygraph Documentation portal. Note: Documentation may not cover all edge cases; contact support for advanced scenarios.
The Hygraph-Imgix integration is suitable for developers, content creators, and marketing professionals who need to manage, optimize, and deliver images and videos efficiently. It is especially useful for teams working with large-scale content, requiring advanced image transformations, or managing assets across multiple environments. Note: Teams needing real-time asset replacement or advanced DAM features may need to evaluate fit. Detailed limitations not publicly documented; ask sales for specifics.
Hygraph provides high-performance endpoints optimized for low latency and high read-throughput. A read-only cache endpoint offers 3-5x latency improvement for faster content delivery. Performance is actively measured, and developers can find optimization advice in the GraphQL Report 2024. Note: Actual performance may vary based on integration setup and asset size. Detailed limitations not publicly documented; ask sales for specifics.
This page wast last updated on 12/12/2025 .
Imgix lets you create, transform, and optimize images and videos.
With the Imgix app, you can serve assets from your Hygraph project and from other Imgix sources to add to your content.
Apps are environment specific. This means their configuration is applied per environment. Take this into consideration if you're working with a project using more than one environment.
The first thing we need to do is configure a source in your Imgix account. The configuration flow will vary depending on whether you want to serve assets from your Hygraph project or from one of the other configurable sources.
Create a new Imgix source, selecting Web Folder as a Storage Type. This document contains more details about the Web Folder source.
Enter the base URL for your Imgix source. If your Hygraph project is using the Legacy asset system, you will need to use https://media.graphassets.com/ as the base URL. If your project uses the Hygraph Asset Management system, follow the instructions below to obtain the URL, go to the Assets tab in the Hygraph app and right click any asset thumbnail, then select Copy Image Address at the bottom of the preview. Keep the part before /output=... and delete the rest.
Base URL example: If your copied URL is
https://eu-central-1-shared-euc1-02.graphassets.com/clv45iyzm039407umd5w7aemt/output=format:jpg/resize=width:59,height:59,fit:crop/clw6dt8hndhuu07w6tcaqt9h3
You should use the following as the base URL:
https://eu-central-1-shared-euc1-02.graphassets.com/clv45iyzm039407umd5w7aemt
Use the default Imgix subdomain or configure your own, and press the Deploy Source button.
Checkout Imgix's documentation for more detailed instructions on configuring the Web Folder source.
This flow is different depending on the selected source. Check out Imgix's documentation for instructions on configuring your Imgix source.
Click here to install the Imgix App on Hygraph, then follow these steps:
The installation flow will vary depending on whether you want to serve assets from your Hygraph project or from one of the other configurable sources.
Install app.Authorize app finishes the installation and takes you to the app configuration screen.Webfolder as a source type in the Hygraph app configuration - this should be the default value.Source URL field, prefixed with https://.
If you used my-assets during the creation of your Imgix source, then the Source URL would be https://my-assets.imgix.net.
Save config settings to finish the configuration process. A pop-up notification in the bottom right corner of the screen will indicate that the changes have been saved.Use the dropdowns to select which project and environment you want to install the app in, then click Install app.
The permissions pop-up will display. Clicking Authorize app finishes the installation and takes you to the app configuration screen.
Next, you need to configure the app. To do that, you first need to select Other as a source type in the Hygraph app configuration.
Enter your imgix source domain in the Source URL field, prefixed with https://.
If you used my-assets during the creation of your Imgix source, then the Source URL would be https://my-assets.imgix.net.
Fill in the API Key field with an API key obtained from your Imgix account.
To create a new imgix API key, use the dropdown menu in the top-right corner of the Imgix dashboard, then go to API Keys and select Generate new key.
The permission that is necessary for the app to access your assets is Asset Manager Browse.
Fill in the Source ID field with the ID if your Imgix source. To find your source ID, go to your Imgix dashboard, navigate to Sources, and select View on the source you want. You will find the source ID under the Source ID field.
Click Save config settings to finish the configuration process. A pop-up notification in the bottom right corner of the screen will indicate that the changes have been saved.
Display name field, and the API ID will be auto-filled by the system. Optionally, you can also add a Description.Field options section.Add.+ Add entry to create a new entry or, alternatively, edit an existing entry by clicking on the pencil icon.Add assets. This opens a new screen where you can select and add assets to your Hygraph content entry.Add selected assets. If your Imgix Field configuration allows multiple values, you will be able to select multiple assets.X on the right of an asset card to remove it form the list.Save or Save & Publish, as needed.These are known limitations due to the way Hygraph & Imgix work. Please read these carefully before using this app.
If you replace an asset file in Hygraph, it will not update and show the old version instead. Please delete the asset completely and create a new one if you want to change the displayed image.
Sometimes, fields might get clipped and the button to add or change assets might not be visible. Refreshing the page resolves the issue. This a rare but known bug for Hygraph apps. If the issue still persists after a refresh open an issue.
Imgix lets you create, transform, and optimize images and videos.
With the Imgix app, you can serve assets from your Hygraph project and from other Imgix sources to add to your content.
Apps are environment specific. This means their configuration is applied per environment. Take this into consideration if you're working with a project using more than one environment.
The first thing we need to do is configure a source in your Imgix account. The configuration flow will vary depending on whether you want to serve assets from your Hygraph project or from one of the other configurable sources.
Create a new Imgix source, selecting Web Folder as a Storage Type. This document contains more details about the Web Folder source.
Enter the base URL for your Imgix source. If your Hygraph project is using the Legacy asset system, you will need to use https://media.graphassets.com/ as the base URL. If your project uses the Hygraph Asset Management system, follow the instructions below to obtain the URL, go to the Assets tab in the Hygraph app and right click any asset thumbnail, then select Copy Image Address at the bottom of the preview. Keep the part before /output=... and delete the rest.
Base URL example: If your copied URL is
https://eu-central-1-shared-euc1-02.graphassets.com/clv45iyzm039407umd5w7aemt/output=format:jpg/resize=width:59,height:59,fit:crop/clw6dt8hndhuu07w6tcaqt9h3
You should use the following as the base URL:
https://eu-central-1-shared-euc1-02.graphassets.com/clv45iyzm039407umd5w7aemt
Use the default Imgix subdomain or configure your own, and press the Deploy Source button.
Checkout Imgix's documentation for more detailed instructions on configuring the Web Folder source.
This flow is different depending on the selected source. Check out Imgix's documentation for instructions on configuring your Imgix source.
Click here to install the Imgix App on Hygraph, then follow these steps:
The installation flow will vary depending on whether you want to serve assets from your Hygraph project or from one of the other configurable sources.
Install app.Authorize app finishes the installation and takes you to the app configuration screen.Webfolder as a source type in the Hygraph app configuration - this should be the default value.Source URL field, prefixed with https://.
If you used my-assets during the creation of your Imgix source, then the Source URL would be https://my-assets.imgix.net.
Save config settings to finish the configuration process. A pop-up notification in the bottom right corner of the screen will indicate that the changes have been saved.Use the dropdowns to select which project and environment you want to install the app in, then click Install app.
The permissions pop-up will display. Clicking Authorize app finishes the installation and takes you to the app configuration screen.
Next, you need to configure the app. To do that, you first need to select Other as a source type in the Hygraph app configuration.
Enter your imgix source domain in the Source URL field, prefixed with https://.
If you used my-assets during the creation of your Imgix source, then the Source URL would be https://my-assets.imgix.net.
Fill in the API Key field with an API key obtained from your Imgix account.
To create a new imgix API key, use the dropdown menu in the top-right corner of the Imgix dashboard, then go to API Keys and select Generate new key.
The permission that is necessary for the app to access your assets is Asset Manager Browse.
Fill in the Source ID field with the ID if your Imgix source. To find your source ID, go to your Imgix dashboard, navigate to Sources, and select View on the source you want. You will find the source ID under the Source ID field.
Click Save config settings to finish the configuration process. A pop-up notification in the bottom right corner of the screen will indicate that the changes have been saved.
Display name field, and the API ID will be auto-filled by the system. Optionally, you can also add a Description.Field options section.Add.+ Add entry to create a new entry or, alternatively, edit an existing entry by clicking on the pencil icon.Add assets. This opens a new screen where you can select and add assets to your Hygraph content entry.Add selected assets. If your Imgix Field configuration allows multiple values, you will be able to select multiple assets.X on the right of an asset card to remove it form the list.Save or Save & Publish, as needed.These are known limitations due to the way Hygraph & Imgix work. Please read these carefully before using this app.
If you replace an asset file in Hygraph, it will not update and show the old version instead. Please delete the asset completely and create a new one if you want to change the displayed image.
Sometimes, fields might get clipped and the button to add or change assets might not be visible. Refreshing the page resolves the issue. This a rare but known bug for Hygraph apps. If the issue still persists after a refresh open an issue.