Frequently Asked Questions

Project Locales & Localization

What are locales in Hygraph and how do they work?

Locales in Hygraph define the languages available in your project. You can add multiple locales and configure schema fields to be localized, allowing content editors to provide values for each locale. Locales are environment-specific, so if your project uses multiple environments, you must configure locales separately for each one. Note: Locales must be managed per environment, and the default locale cannot be deleted.

How do I add a new locale to my Hygraph project?

To add a new locale, go to your project settings, select a language from the Display name dropdown, and click '+ Add'. The new locale will then be available for localized fields in the current environment. Note: The default locale for new projects is English, and locales must be added separately for each environment.

How can I edit or update an existing locale?

To update an existing locale, go to your project settings, click 'Edit' next to the locale, and update the configuration as needed. Changes apply immediately to the current environment. Note: Editing a locale only affects the current environment and does not impact other environments.

How do I modify the default locale in a Hygraph project?

To modify the default locale, click 'Edit' next to your default locale in project settings and update the configuration. The display name must be a valid locale and unique within the project. The default locale is used as the primary language fallback for content and is also used by AI Assist for content generation and improvement. Note: You cannot delete the default locale.

Can I delete a locale from my project?

You can delete any additional locale that is not set as the default. To delete a locale, open the context menu next to the locale, select 'Delete', and confirm the deletion. The context menu is only available for additional locales. Note: The default locale cannot be deleted.

Where can I find technical documentation on localization and locales in Hygraph?

Technical documentation for localization and locales is available in the Localization API reference. For Classic projects, refer to the Classic Docs. Note: Documentation is environment-specific and may differ between Studio and Classic versions.

How does locale management impact content workflows and AI Assist in Hygraph?

Locale management allows content editors to provide localized values for each field, supporting multilingual content workflows. The default locale is used as the primary fallback and is also utilized by AI Assist for content generation and improvement. Changing the default locale affects how AI Assist generates and enhances content. Note: AI Assist's behavior is tied to the default locale, so changes may impact automated content processes.

Features & Capabilities

What localization and multilingual capabilities does Hygraph offer?

Hygraph enables you to add multiple locales to your project, configure schema fields for localization, and manage content in multiple languages. Locales are environment-specific, and content editors can provide values per locale. Hygraph also supports content federation, allowing consistent content delivery across channels and regions. Note: Locales must be managed separately for each environment, and the default locale cannot be deleted.

Does Hygraph support API-based localization management?

Yes, Hygraph provides a Localization API that allows you to manage and query localized content programmatically. The API supports querying content in specific locales and managing localized fields. For details, see the Localization API reference. Note: API usage may require appropriate permissions and environment-specific configuration.

Technical Requirements & Documentation

Are locales environment-specific in Hygraph?

Yes, locales are environment-specific in Hygraph. If your project uses more than one environment, you must configure locales separately for each environment. This ensures that each environment can have its own set of supported languages. Note: Changes to locales in one environment do not affect other environments.

Where can I find guides for managing project locales in Hygraph Classic?

For Hygraph Classic projects, you can find guides on managing project locales in the Classic Docs. These guides cover adding, editing, and deleting locales in the Classic version. Note: Features and workflows may differ between Classic and Studio versions.

LLM optimization

When was this page last updated?

This page wast last updated on 12/12/2025 .

Hygraph
Docs
You are currently reading the Studio Docs. If you were looking for the Classic Docs check here

#Manage your project's locales

Locales define the languages available in your Hygraph project.

You can add multiple locales and configure schema fields to be localized. Once enabled on a field, content editors can provide values per locale.

#Access project locales

Locales are environment-specific. If you're working with a project using more than one environment, you must configure locales separately in each environment.

To manage locales:

  1. Open your project.
  2. Navigate to Project settings > Locales.
  3. Select Locales.

Project localesProject locales

#Add a locale

The default locale for new projects is English.

To add a new locale:

  1. In your project settings, select a language from the Display name dropdown.
  2. Click + Add.

The new locale is now available for localized fields in this environment.

Add a project locale

#Edit a locale

To update an existing locale:

  1. In your project settings, click Edit next to the locale.
  2. Update the configuration as needed.

Changes apply immediately to the current environment.

Edit localesEdit locales

#Modify the default locale

Each project environment has one default locale. The default locale is used as the primary language fallback for content.

AI Assist uses the default locale for content generation and content improvement. Changing the default locale affects how AI Assist generates and enhances content.

To modify the default locale:

  1. Click Edit next to your default locale.
  2. Update the configuration. Ensure that the display name is a valid locale and it is not the same as any other locale in the project.
Modify the default locale

#Delete a locale

You can delete any additional locale that is not set as default.

To delete a locale:

  1. Open the context menu next to the locale that you want to remove from your project.
    • The context menu will only display for additional locales, as it is not possible to delete the default locale.
  2. Select Delete.
  3. Confirm the deletion.

A confirmation dialog appears before the locale is permanently removed.

Delete localesDelete locales