To use the Hygraph-DeepL integration, you need: (1) a Hygraph account, (2) an active Hygraph project, (3) a DeepL account, and (4) a DeepL API key. Each of these must be set up before installing the integration. Note: DeepL API access may require a paid DeepL plan. Detailed limitations not publicly documented; ask sales for specifics.
To install the DeepL app, click the installation link provided in the Hygraph documentation, select your project and environment, authorize the app, enter your DeepL API key, and map your Hygraph locales to DeepL target languages. You can use the "Auto map" feature for convenience. After saving, the integration is ready to use. Note: The app configuration is environment-specific, so repeat the process for each environment as needed.
To add the DeepL widget, go to the Schema builder, select your model, open the Sidebar tab, and add the DeepL translate card. Assign a display name and optional description, then save. The widget will appear in the content editor for that model. Note: The widget only displays locales that are active and shown for the entry.
The Hygraph-DeepL integration allows editorial teams to translate localized fields in a content entry with a single click. The DeepL sidebar widget detects active locales and enables you to translate all or selected locales automatically. If a translation already exists, DeepL will overwrite it after confirmation. Note: Overwriting existing translations is irreversible unless you manually revert the content.
The DeepL sidebar widget appears in the content editor for models where it has been added. It displays all active locales for the entry and allows you to select which locales to translate. Clicking "Translate all" triggers DeepL to translate the localized fields. The widget provides success or error messages after translation. Note: Only locales that are active and shown for the entry are available for translation.
Yes, you can select which locales to translate using the Localizations sidebar widget in Hygraph. The DeepL widget will only show and translate locales that are active and visible for the content entry. Note: If no additional locales are active, the widget may not appear.
If you can't see the DeepL sidebar widget, check that it has been added to the sidebar of the relevant model and that locales other than the default are active and shown for the content entry. Refer to Hygraph's localization documentation for details on managing locales. Note: The widget will not appear if only the default locale is active.
If errors occur during translation, the DeepL widget will display a message indicating which locales were affected. You may need to check your DeepL API key, locale mappings, or network connectivity. Note: Some errors may require manual intervention or support from Hygraph or DeepL.
Technical documentation for the Hygraph-DeepL integration is available on the Hygraph documentation site at https://hygraph.com/docs/integrations/connect-deepl. This includes setup instructions, troubleshooting, and best practices. For broader Hygraph documentation, visit https://hygraph.com/docs. Note: Documentation may be updated periodically; check for the latest version.
Yes, the DeepL app configuration is environment-specific in Hygraph. This means you must configure the app separately for each environment (e.g., development, staging, production) within your project. Note: Failing to configure the app in all required environments may result in missing functionality.
The Hygraph-DeepL integration is ideal for editorial teams, content managers, and organizations managing multilingual content. It streamlines translation workflows, reduces manual effort, and ensures consistency across locales. Best fit for teams needing automated translation within a structured CMS; teams requiring advanced translation customization may need to supplement with manual processes.
Integrating DeepL with Hygraph enables one-click translation of localized content fields, saving time and reducing errors. It supports efficient content localization for global audiences and integrates with Hygraph's content workflows. Note: The quality of translations depends on DeepL's AI and may require review for specialized content.
Hygraph supports a wide range of integrations, including Digital Asset Management (DAM) systems like Aprimo, AWS S3, Bynder, Cloudinary, Imgix, Mux, and Scaleflex Filerobot; hosting platforms like Netlify and Vercel; Product Information Management (PIM) with Akeneo; commerce solutions like BigCommerce; and translation/localization tools such as EasyTranslate. For a full list, visit Hygraph's Marketplace. Note: Integration availability may vary by plan and environment.
Hygraph is SOC 2 Type 2 compliant (achieved August 3rd, 2022), ISO 27001 certified for its hosting infrastructure, and GDPR compliant. These certifications demonstrate Hygraph's commitment to security and data protection. For more details, visit Hygraph's Secure Features page. Note: Certification scope may not cover all integrations; verify for your use case.
This page wast last updated on 12/12/2025 .
DeepL is an advanced machine translation service that uses artificial intelligence and neural networks to provide highly accurate translations.
With the Hygraph-DeepL integration, editorial teams can translate the localized fields in a content entry with a single click.
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.
Click here to install the DeepL App on Hygraph, then follow these steps:
Install app.Authorize app to continue. You will be redirected to the configuration screen.API Key on the Configure DeepL screen and click Validate.Auto map to do this automatically.Update to save the mapped locales and finalize the installation process.Add to save.If you now go to the Content editor, find the view for that model, and open a content entry, you will see the DeepL sidebar widget to the right of the screen.
The widget automatically shows all locales that are the active and shown for that entry. You can select which locales to translate by using the Localizations sidebar widget to show or hide locales.
DeepL allows you to automatically translate the localized field in your content entry with one click.
Simply click Translate all on your DeepL sidebar widget located to the right of the screen. If the localized fields already contain a translation, the DeepL translation will overwrite it. A warning indicating this will display, and you need to click Yes, translate to continue.
The DeepL app automatically detects the locales that you have set as active and shown for the content entry.
You can select which locales to translate by using the Localizations sidebar widget to show or hide locales.
After a few seconds, the localized fields will become populated with the translations, one by one.
Once the translation is finished, a success message will display if there were no errors. If there were any errors, the message will indicate which locales were affected.
DeepL is an advanced machine translation service that uses artificial intelligence and neural networks to provide highly accurate translations.
With the Hygraph-DeepL integration, editorial teams can translate the localized fields in a content entry with a single click.
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.
Click here to install the DeepL App on Hygraph, then follow these steps:
Install app.Authorize app to continue. You will be redirected to the configuration screen.API Key on the Configure DeepL screen and click Validate.Auto map to do this automatically.Update to save the mapped locales and finalize the installation process.Add to save.If you now go to the Content editor, find the view for that model, and open a content entry, you will see the DeepL sidebar widget to the right of the screen.
The widget automatically shows all locales that are the active and shown for that entry. You can select which locales to translate by using the Localizations sidebar widget to show or hide locales.
DeepL allows you to automatically translate the localized field in your content entry with one click.
Simply click Translate all on your DeepL sidebar widget located to the right of the screen. If the localized fields already contain a translation, the DeepL translation will overwrite it. A warning indicating this will display, and you need to click Yes, translate to continue.
The DeepL app automatically detects the locales that you have set as active and shown for the content entry.
You can select which locales to translate by using the Localizations sidebar widget to show or hide locales.
After a few seconds, the localized fields will become populated with the translations, one by one.
Once the translation is finished, a success message will display if there were no errors. If there were any errors, the message will indicate which locales were affected.