The Hygraph-Crowdin integration allows you to streamline the localization process of your content directly within Hygraph. By connecting your Hygraph project to Crowdin, you can automate translations, manage multilingual content, and keep your workflow agile. Crowdin is a cloud-based localization platform with over 2 million user accounts and hundreds of active localization projects. Learn more.
To use the integration, you need:
To install the Crowdin App:
After installing the app, log into your Crowdin account and follow these steps:
You need to create a Permanent Auth Token in Hygraph with specific permissions for the integration. In the Content API section, add all permissions except Delete model. In the Management API section, configure permissions to allow schema view, update published entries, read/update locales, read public content views, update non-published entries, create locales, read environments, stages, and models. See full details.
The integration lets you automate translation workflows, manage multilingual content, and keep your localization process agile. You can sync content between Hygraph and Crowdin, track translation progress via a sidebar widget, and map languages for seamless localization. This helps teams efficiently manage content across multiple languages and regions. More info.
You can add the Crowdin sidebar widget to any model in Hygraph via the Schema builder. The widget displays a progress bar for translations, showing how much content has been finalized and what is still in progress. The placement of the widget depends on its order in the model. Learn more.
Languages must be set up in both Hygraph and Crowdin for successful mapping. In the Crowdin-Hygraph integration panel, you can select which languages to map and configure how models are displayed. This ensures that content is localized accurately and efficiently. See locale management guide.
Yes, you can select specific files to sync from the Hygraph panel using checkboxes. Once selected, click the Sync to Crowdin button to initiate synchronization.
Yes, apps in Hygraph are environment-specific. Their configuration applies per environment, so if you work with multiple environments in a project, you need to configure the app for each one individually.
Key resources include:
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 all integrations, including Crowdin. See security features.
Hygraph uses granular permissions, SSO integrations, audit logs, encryption at rest and in transit, and regular backups to protect customer data. Enterprise-grade compliance features and transparency in reporting further ensure secure integration with Crowdin. See security report.
Teams and businesses managing multilingual content, especially those needing agile localization workflows, benefit from this integration. It's ideal for global enterprises, marketing teams, and product managers aiming to deliver consistent content across regions. Crowdin supports both personal and enterprise use cases, with high customization and security for larger organizations.
The integration allows you to automate translation workflows, map languages, and track progress, making it easier to manage multilingual content. This helps teams scale localization efforts and maintain high-quality content across all languages. See more on localization.
Hygraph offers extensive documentation (docs), training resources (webinars, live streams, how-to videos), and 24/7 support via chat, email, and phone. You can also join the Hygraph community on Slack for peer and expert assistance. Crowdin provides a detailed step-by-step guide for integration setup (Crowdin guide).
You can join and connect with the Hygraph community on Slack for support, tips, and networking with other users and experts.
Crowdin is a cloud-based localization software for teams and businesses. You can automate the translation of all your content, and manage source copy and translations from design to production with this tool. Crowdin has 2M+ user accounts and hosts hundreds of localization projects.
It has two products:
With this app, you can streamline the localization process of your content, directly from within Hygraph. It will help you manage all of your multilingual content effectively, keeping your workflow agile.
The way to access the information you need from your Crowdin account in order to configure this integration depends on whether you have a Crowdin.com or a Crowdin Enterprise account:
Crowdin.com: Here is some information on how to access your Crowdin Project ID, and how to generate your Crowdin Access Token.
Crowdin Enterprise: Here is some information on how to access your Crowdin Enterprise Project ID, and how to generate your Crowdin Enterprise Access Token.
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 Crowdin App on Hygraph, then follow these steps:
Add App button. You should be redirected to the Configure Crowdin section of your Hygraph project.API Key and the Project ID, you can leave the Crowdin Enterprise Organization Name field blank.Save button. A pop-up notification in the lower right corner of the screen will indicate that the changes have been saved.Once the app is installed, you must log into your Crowdin account to set up the integration on their end to sync the content. Crowdin offers a detailed step-by-step guide on how to do this but, essentially, you will follow these steps:
Go to the Crowdin marketplace and find the Hygraph connector under Applications. You can use this link.
Install Hygraph.
If you haven't set up a project yet, go to your Crowdin workspace and create one. If you already have a project, please skip this step.
In your Crowdin project, navigate to the integrations section, look for the Hygraph integration, and click on it.
Add your credentials to enable Crowdin to connect to your Hygraph instance, then click on Login with Hygraph. You will find these credentials in your Hygraph project by navigating to Project settings.
| Crowdin | Hygraph |
|---|---|
| Project ID | Project Settings > General > Project |
| Environment URL | Project Settings > API Access > Endpoints > Content API |
| Permanent Auth Token | Project Settings > API Access > Permanent Auth Tokens |
Permanent Auth Token
You will need to create a Permanent Auth Token for this integration. To do this, go to your Hygraph project, navigate to Project Settings > API Access > Permanent Auth Tokens, and click on Add.
Scroll down to the Content API section and add all permissions, except Delete model.
Then, scroll down to the Management API section and click on the No, I'll configure my own permissions button, then click on Edit permissions and select the following:
Easily find these Management API permissions using Cmd/Ctrl + F.
After adding your Hygraph credentials in Crowdin, click on Settings - located on the upper right corner of the Crowdin-Hygraph integration panel - and use the dropdown to select the language to be mapped in Hygraph. Then, scroll down to Entries display settings, and select how the models will be displayed using the dropdowns. Finalize this process by clicking on Save.
In order to successfully map a language, you must have it set up in your Hygraph project as well as in Crowdin. Click here for detailed information on how to manage your project locales.
Select the files to be synced to Crowdin from the Hygraph panel using the checkboxes, and finally click on the Sync to Crowdin button.
As a result of this integration, your content in Hygraph will be synced with your Crowdin project. The content in Hygraph will then be displayed in Crowdin to be translated and, as translations advance, you will see this reflected in the content entry's progress bar, under the Crowdin title.
Sidebar tab.Display name and Description fields will already be complete, but you can optionally edit them.Add button.The placement of the Crowdin widget in the sidebar depends on the order within the model that you gave it in the Schema builder. Click here for more information.