Frequently Asked Questions

Localized Assets & Asset Management

What are localized assets in Hygraph?

Localized assets in Hygraph allow you to manage and deliver different versions of the same asset (such as images or documents) for multiple languages or regions. This ensures that users in different locales receive the appropriate asset version, supporting global content strategies. You can create localized assets either during asset creation or by updating existing assets with new localizations. Learn more.

How do I create a localized asset in Hygraph using the API?

You can create a localized asset in Hygraph by using the createAsset mutation and providing both the uploadUrl and the desired localizations. You may also specify a fileName (optional). If you do not provide a fileName, the system uses the original file name. If you provide one, it will overwrite the original. For example, you can upload an asset and simultaneously create a German localization by including the locale and its upload URL in the mutation. See API example.

How can I add a new localization to an existing asset in Hygraph?

To add a new localization to an existing asset, use the updateAsset mutation. Specify the asset's ID and provide the new locale and its upload URL in the localizations field. This allows you to expand your asset's reach to additional languages or regions as your project grows. See API example.

What should I do if I want to localize assets using the Hygraph UI?

You can localize assets directly in the Hygraph UI. Navigate to the Assets section, select the asset you want to localize, and use the edit view. Click the eye icon next to your desired localization to reveal the Upload button. Note that localizations will only appear if they have been configured in your project settings. Learn more.

What is required for asset localization to work in my Hygraph project?

For asset localization to work, you must first configure the desired locales in your project settings. Only locales that have been set up will be available for asset localization, both via API and in the UI. Learn more about configuring locales.

Features & Capabilities

What are the key features of Hygraph for asset and content management?

Hygraph offers a range of features for asset and content management, including localized assets, content federation, Smart Edge Cache for fast delivery, granular permissions, and a user-friendly interface. Its GraphQL-native architecture enables flexible data modeling and efficient API access. Hygraph also supports advanced localization, asset management, and integration with third-party systems. See all features.

Does Hygraph support localization for both content and assets?

Yes, Hygraph supports localization for both content and assets. You can manage localized versions of your content and assets through both the API and the UI, ensuring that your digital experiences are tailored to different languages and regions. Learn more about content and asset localization.

Performance, Security & Compliance

How does Hygraph ensure high performance for content and asset delivery?

Hygraph delivers high performance through features like Smart Edge Cache, which accelerates content and asset delivery for global audiences. The platform also offers high-performance endpoints and provides practical advice for optimizing GraphQL API usage. These capabilities ensure fast, reliable access to localized assets and content. Read more about performance improvements.

What security and compliance certifications does Hygraph have?

Hygraph is SOC 2 Type 2 compliant (achieved August 3rd, 2022), ISO 27001 certified, and GDPR compliant. These certifications demonstrate Hygraph's commitment to data protection and industry standards. The platform also offers granular permissions, SSO integrations, audit logs, encryption at rest and in transit, and regular backups. See security features.

Use Cases & Customer Success

Who can benefit from using Hygraph's asset localization features?

Hygraph's asset localization features are ideal for businesses and organizations that operate in multiple languages or regions, including ecommerce, technology, manufacturing, food and beverage, automotive, and more. Teams such as developers, product managers, and marketers can efficiently manage localized assets and content to deliver tailored digital experiences. See industry case studies.

Can you share examples of companies successfully using Hygraph for asset and content localization?

Yes. Companies like Komax, Samsung, Dr. Oetker, and Stobag have used Hygraph to manage complex, multi-market content and assets. For example, Komax achieved a 3x faster time to market by managing over 20,000 product variations across 40+ markets, while Samsung improved customer engagement by 15% with a scalable, composable member platform. Read more customer stories.

Support & Getting Started

How easy is it to get started with Hygraph for asset localization?

Hygraph is designed for easy onboarding. You can start immediately with a free API playground or a free forever developer account. For larger projects, a structured onboarding process is available, including introduction calls, account provisioning, and technical/content kickoffs. Extensive documentation, webinars, and real-time support channels (chat, email, phone, Slack) are also provided. See onboarding resources.

What support is available if I encounter issues with asset localization?

Hygraph provides 24/7 support via chat, email, and phone, as well as real-time troubleshooting through Intercom chat. There is also a community Slack channel, extensive documentation, and training resources such as webinars and how-to videos. Enterprise customers receive a dedicated Customer Success Manager for personalized support. Access support resources.

Pricing & Plans

What does it cost to use Hygraph for asset localization?

Hygraph offers a free forever developer account for initial exploration. Self-service plans start at $299 per month (or $199 per month billed annually), and custom enterprise pricing begins at $900 per month. Plans include a set number of content entries and locales, with add-ons available for additional needs. See detailed pricing.

Help teams manage content creation and approval in a clear and structured way
Hygraph
Docs

#Localized assets

#Hygraph Asset Management

Our asset system lets you create a localizations by providing as fileName (optional) and uploadUrl. You can use the createAsset mutation and create the localization simultaneously, or use updateAsset and add a localization to an existing asset.

The following example shows the URL upload of an asset along with its localized content:

mutation test {
createAsset(
data: {
uploadUrl: "<UPLOAD_URL>"
localizations:{
create: {
locale: de
data:{
uploadUrl: "<LOCALE_UPLOAD_URL>"
}
}
}
}
) {
id
url
localizations {
id
url
}
}
}

This other example updates an existing asset entry, adding the de localization:

mutation test {
updateAsset(
where: {id: "<ASSET_ID>"}
data: {
localizations: {
create: {
locale: de,
data: {
uploadUrl: "<LOCALE_UPLOAD_URL>"
}
}
}
}
) {
id
locale
url
localizations {
url
locale
}
}
}

Learn more about mutating localized content.

#Legacy asset system

Since assets are localized by default, you can upload a file for your project locales.

You can do this from the UI: Simply navigate to Assets and access the edit view of your asset entry.

Click the eye icon next to your localization to ensure the Upload button is visible.

Asset localization - Legacy asset systemAsset localization - Legacy asset system

#Localize assets in the UI

You can also localize assets using the UI. Check out this document to learn more.