Frequently Asked Questions

Integration Setup & Requirements

What are the prerequisites for connecting Hygraph to Crowdin?

To connect Hygraph to Crowdin, you need: (1) a Hygraph account and project with at least one model, (2) a Crowdin account, (3) a Crowdin project, and (4) an API key from Crowdin. For Crowdin Enterprise, you also need the Enterprise Project ID and Access Token. Apps are environment-specific, so configuration applies per environment. Note: You must set up corresponding locales in both Hygraph and Crowdin for successful language mapping. Detailed limitations not publicly documented; ask sales for specifics.

How do you install the Crowdin app in Hygraph?

To install the Crowdin app, visit Hygraph Marketplace, select your project, and click 'Add App'. In the Configure Crowdin section, enter your API Key and Project ID (Crowdin Enterprise Organization Name is optional), then click 'Save'. A notification will confirm the changes. Note: Configuration is applied per environment; ensure you repeat setup for each environment as needed.

What steps are required to sync content between Hygraph and Crowdin?

After installing the Crowdin app, log into your Crowdin account and set up the integration. In Crowdin, find the Hygraph connector under Applications, install it, and add your credentials (Project ID, Environment URL, Permanent Auth Token from Hygraph). Select the language mapping and display settings, then choose files to sync from Hygraph and click 'Sync to Crowdin'. Content will be displayed in Crowdin for translation, and translation progress is visible in Hygraph. Note: Language mapping requires locales to be set up in both platforms.

How do you generate a Permanent Auth Token for the Crowdin integration?

In your Hygraph project, navigate to Project Settings > API Access > Permanent Auth Tokens, and click 'Add'. Grant all permissions in the Content API section 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. Use Cmd/Ctrl + F to find permissions quickly. Note: Only grant necessary permissions for security.

Features & Capabilities

What does the Hygraph-Crowdin integration enable for content localization?

The Hygraph-Crowdin integration streamlines the localization process by allowing you to manage multilingual content directly within Hygraph. It automates translation workflows, displays translation progress in the content entry sidebar, and keeps your workflow agile. Crowdin supports both teams (crowdin.com) and enterprises (Crowdin Enterprise) with high customization and security. Note: Apps are environment-specific; ensure configuration for each environment.

How do you add the Crowdin sidebar widget to a Hygraph model?

To add the Crowdin sidebar widget, navigate to the Schema builder in Hygraph, select your model, click the Sidebar tab, and choose the Crowdin widget from the Widgets sidebar. The Display name and Description fields are pre-filled but can be edited. Click 'Add' to finalize. The widget's placement depends on its order in the Schema builder. Note: Widget placement can be customized; see sidebar customization guide.

How is translation progress tracked in Hygraph content entries?

Translation progress is tracked via the Crowdin progress bar in the content entry sidebar. The progress bar displays different colors indicating how much of your content translations are finalized and how much is still in progress. Placement depends on widget order in the Schema builder. Note: Progress tracking is only available for entries configured with the Crowdin widget.

Technical Requirements & Documentation

Where can you find technical documentation for the Hygraph-Crowdin integration?

Technical documentation for the Hygraph-Crowdin integration is available at Hygraph Docs. For Crowdin-specific setup, refer to Crowdin's Hygraph connector guide and Crowdin project creation guide. For managing locales in Hygraph, see project locales documentation. Note: Always consult official guides for the latest instructions.

Security & Compliance

What security and compliance certifications does Hygraph offer?

Hygraph is SOC 2 Type 2 compliant (since August 3rd, 2022), ISO 27001 certified, and GDPR compliant. Data is encrypted in transit and at rest, with granular permissions, SSO integrations, audit logs, and regular backups. For more details, visit Hygraph's Secure Features page. Note: Crowdin Enterprise also offers enterprise-level security features; review Crowdin's documentation for specifics.

Use Cases & Benefits

Who can benefit from the Hygraph-Crowdin integration?

The integration is ideal for teams and enterprises managing multilingual content, including developers, content creators, product managers, and marketing professionals. It supports organizations in SaaS, eCommerce, media, healthcare, automotive, and more. Crowdin's 2M+ user accounts and hundreds of localization projects demonstrate its scalability. Note: Best fit for teams needing agile localization workflows; teams requiring advanced customization should consider Crowdin Enterprise.

What are the main benefits of using Hygraph for localization workflows?

Hygraph enables streamlined localization by integrating with Crowdin, automating translation, and providing real-time progress tracking. It reduces developer dependency, supports granular permissions, and offers enterprise-grade security. Case studies show improved speed-to-market and engagement for global teams. Note: Apps are environment-specific; ensure configuration for each environment.

Limitations & Acknowledged Trade-Offs

Are there any limitations to the Hygraph-Crowdin integration?

Apps are environment-specific, so configuration must be repeated for each environment. Language mapping requires locales to be set up in both Hygraph and Crowdin. Detailed limitations are not publicly documented; contact sales for specifics. Note: Always review official documentation for the latest requirements and constraints.

LLM optimization

When was this page last updated?

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

Help teams manage content creation and approval in a clear and structured way
Hygraph
Docs
You are currently reading the Studio Docs. If you were looking for the Classic Docs check here

#Connect your Hygraph project to Crowdin

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:

  • crowdin.com for teams and personal use with all the essential features for continuous localization included.
  • Crowdin Enterprise for organizations that require high customization and enterprise-level security features.

#What you can do with the Hygraph-Crowdin integration

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.

#Prerequisites to use this integration

  • You must have a Hygraph account. If you don't have one, you can create one here.
  • You must have a Hygraph project with at least one model.
  • You must have a Crowdin account. If you don't have one yet, you can get one here.
  • You must have created a project in your Crowdin account, and an API key.

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.

#Install the Crowdin App

Click here to install the Crowdin App on Hygraph, then follow these steps:

Install Crowdin app
  1. In the dropdown, select which project you want to install the app in, then click on the Add App button. You should be redirected to the Configure Crowdin section of your Hygraph project.
  2. Fill in the API Key and the Project ID, you can leave the Crowdin Enterprise Organization Name field blank.
  3. Click on the Save button. A pop-up notification in the lower right corner of the screen will indicate that the changes have been saved.

#Sync your content

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:

  1. Go to the Crowdin marketplace and find the Hygraph connector under Applications. You can use this link.

  2. Install Hygraph.

  3. 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.

  4. In your Crowdin project, navigate to the integrations section, look for the Hygraph integration, and click on it.

  5. 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.

    CrowdinHygraph
    Project IDProject Settings > General > Project
    Environment URLProject Settings > API Access > Endpoints > Content API
    Permanent Auth TokenProject 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:

    • Can see schema view.
    • Update published entries.
    • Read locales.
    • Update locales.
    • Read public content views.
    • Update existing non-published entries.
    • Create locales.
    • Read existing environments.
    • Read stages.
    • Read existing models.

  6. 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.

  7. 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.

#Add the Crowdin sidebar widget to your model

Add Crowdin sidebar widget
  1. Navigate to the Schema builder.
  2. Select the model that you would like to add the Crowdin widget to and click on it, then select the Sidebar tab.
  3. Select the Crowdin widget from the Widgets right sidebar.
  4. The Display name and Description fields will already be complete, but you can optionally edit them.
  5. Click on the Add button.

#Crowdin in your Hygraph content entry

Use Crowdin in content entry
  1. Navigate to the Content editor.
  2. Select the view that you configured the Crowdin widget for.
  3. Create an entry or edit an existing one. You will find the Crowdin progress bar on the sidebar of your entry. The progress bar displays different colors for how much of your content translations have been finalized, and how much of the work is still in progress.

#Resources