What is DeepL and how does it integrate with Hygraph?
DeepL is an advanced machine translation service that uses artificial intelligence and neural networks to provide highly accurate translations. The Hygraph-DeepL integration allows editorial teams to translate localized fields in a content entry with a single click, streamlining multilingual content workflows. Learn more.
What are the prerequisites for using the Hygraph-DeepL integration?
Select your project and environment, then click Install app.
Authorize the app in the permissions pop-up.
Enter your DeepL API Key and click Validate.
Map locales by selecting DeepL target languages that match your Hygraph locales, or use Auto map for automatic mapping.
Click Update to save and finalize installation.
Are DeepL app configurations environment-specific in Hygraph?
Yes, DeepL app configurations are environment-specific in Hygraph. This means the configuration is applied per environment, so if your project uses multiple environments, you need to configure the app separately for each one.
Features & Capabilities
What can I do with the Hygraph-DeepL integration?
With the Hygraph-DeepL integration, editorial teams can translate localized fields in a content entry with a single click. The integration automatically detects active locales and allows you to select which locales to translate. Translations are populated instantly, and you can manage which locales are shown using the Localizations sidebar widget. Read more.
How do I add DeepL to the sidebar of a model in Hygraph?
To add DeepL to the sidebar of a model:
Go to the Schema builder and select the model.
Select the Sidebar tab.
Click the DeepL translate card on the right sidebar.
Give the widget a display name and optional description.
Click Add to save. The DeepL sidebar widget will now appear in the content editor for that model.
How do I translate content with DeepL in Hygraph?
To translate content, use the DeepL sidebar widget in the content editor. Click Translate all to automatically translate all localized fields. If fields already contain translations, DeepL will overwrite them after you confirm. Translations are populated within seconds, and a success or error message will display based on the result.
Can I choose which locales to translate with DeepL?
Yes, the DeepL app automatically detects active locales for each content entry. You can select which locales to translate using the Localizations sidebar widget to show or hide locales as needed. Learn more.
Troubleshooting & Support
Why can't I see the DeepL sidebar widget in my Hygraph project?
If you can't see the DeepL sidebar widget, check that:
The widget has been added to the sidebar of the model you're working with.
Locales other than the default have been added and are currently shown for the content entry. For more details, see content localization documentation.
What should I do if translation errors occur during DeepL integration?
If translation errors occur, the system will indicate which locales were affected. Review your API Key, locale mappings, and ensure all prerequisites are met. For persistent issues, consult the integration documentation or reach out to Hygraph support.
Use Cases & Benefits
Who can benefit from the Hygraph-DeepL integration?
Editorial teams, content managers, and businesses managing multilingual content can benefit from the Hygraph-DeepL integration. It streamlines translation workflows, reduces manual effort, and ensures high-quality, consistent content across languages. This is especially valuable for global enterprises and organizations with localization needs. See more on localization.
How does the Hygraph-DeepL integration improve localization efforts?
The integration allows teams to easily scale localization efforts and maintain high-quality content across all languages. Centralized content and automated translation reduce bottlenecks and ensure the latest content is available in every locale. Learn more.
Security & Compliance
Is the Hygraph platform secure and compliant for enterprise use?
Yes, Hygraph is SOC 2 Type 2 compliant (achieved August 3rd, 2022), ISO 27001 certified, and GDPR compliant. These certifications ensure robust security and compliance for enterprise-grade use. For more details, visit the Hygraph security features page.
Support & Resources
What support and resources are available for Hygraph-DeepL integration users?
Hygraph provides extensive documentation (integration guide), 24/7 support via chat, email, and phone, real-time troubleshooting through Intercom chat, and access to a community Slack channel (join here). Training resources such as webinars, live streams, and how-to videos are also available. Enterprise customers receive a dedicated Customer Success Manager for personalized guidance.
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:
Use the dropdowns to select which project and environment you want to install the app in, then click on Install app.
The permissions pop-up will display. Click on Authorize app to continue. You will be redirected to the configuration screen.
Fill in the API Key on the Configure DeepL screen and click Validate.
After the system validates the API Key, you need to map locales. Use the dropdowns to select the DeepL target languages that match your Hygraph locales. You can also click Auto map to do this automatically.
Click Update to save the mapped locales and finalize the installation process.
Navigate to the Schema builder and select the model you want to add the widget to.
Select the Sidebar tab.
Click on the DeepL translate card on the right sidebar.
Give the sidebar widget a display name. You can also optionally give it a description.
Click 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.
Pro Tip
The DeepL app automatically detects the locales that you have set as active and shown for the content entry.
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.
Check that the widget has been added to the sidebar of the model you are creating content for.
Check that locales other than the default one have been added and are currently shown for the content entry you're working on. You can find information on how to add, show or hide translations here.