Crowdin

Crowdin is a cloud-based localization management platform that streamlines the translation process. By integrating Crowdin with Document360, you can automate and enhance the localization of your multilingual knowledge base, combining machine and human translation to ensure accuracy and quality.

Prerequisite: You must have an active Crowdin enterprise account. If you don't have one, sign up for one before starting the integration.

When to use the Crowdin extension

• Your knowledge base is available in multiple languages and you want to keep all language versions in sync without manually exporting and importing content for each article update.
• You work with external translation agencies or freelance translators and want to give them a structured platform to work in — without giving them access to the Document360 portal.
• You want machine translation as a first pass and human review as a second, using Crowdin's built-in workflow and translation engine support.
• You regularly update articles in your source language and need a reliable, low-friction way to push those updates to translators without disrupting your authoring workflow.

Basic setup guide

Step 1 — Create a project in Crowdin

1. Log in to your Crowdin enterprise account and go to your Crowdin workspace.
2. Click Create Project on the right of the screen.
3. Enter the name of your project.

4. Select the source language of your project.

5. Select the target languages for your project.
6. Choose a workflow that maps the flow of content within your project.
7. Click CREATE PROJECT.

Step 2 — Generate an API token in Document360

1. Navigate to Settings () in the left navigation bar of the Knowledge base portal.
2. Go to Knowledge base portal > API Tokens.
3. Click Create API token if this is your first token.
4. Enter a Token name.
5. Select the required methods in the Allowed Method(s) field (GET, POST, PUT, DELETE).
6. Click Generate and copy the token.

Step 3 — Connect Document360 to Crowdin

1. Head back to the Crowdin integration page and select the Crowdin project you created.
2. On the dashboard side menu, go to Integration.
3. From the list of integration options, select the Document360 application.
4. Paste the copied API token into the field.
5. Click Log in with Document360.

Step 4 — Generate an API token from Crowdin and connect to Document360

1. In Crowdin, click your Profile (top right) > Account settings.
2. Go to Access tokens > Personal Access Tokens and click New Token.
3. Enter a token name and select All scopes.
4. Click Create and copy the generated token.

Now, back in Document360:

5. Navigate to Connections > Extensions in the left navigation bar.
6. Under the Translation section, click Connect on the Crowdin tile.
7. Paste the copied Crowdin access token in the API key field.
8. Enter the organization name from your Crowdin account.
9. Click Save.

You can now use the Push to Crowdin option from Document360.

Syncing articles to Crowdin for translation

After integration, you can sync categories and articles from Document360 to your Crowdin project for translation.

1. Log in to your Crowdin account and select the project configured with your knowledge base.
2. On the dashboard side menu, go to Integration.
3. The Crowdin project and Document360 project are shown side-by-side.
4. On the Document360 side, browse or search for the categories and articles you want to sync.
5. Select the content and click SYNC TO.

Push to Crowdin from Document360

After syncing articles, you can push updated content directly from the Document360 article editor without visiting the Crowdin workspace.

Click the Crowdin icon at the top of the article editor (next to the See contributor option) to open the Crowdin Sync panel.

Default language: The panel shows the time of the last push to Crowdin and the Push to Crowdin button.

Non-default languages: The panel also shows the time of the last translation sync from Crowdin, in addition to the last push timestamp.

Click Push to Crowdin to sync the latest article content to your Crowdin project.

Timestamp feature

The Crowdin Sync panel displays two timestamps for each article:

• Last translation sync from Crowdin — the timestamp of the most recent translation push from Crowdin back to Document360.
• Last push to Crowdin — the timestamp of the most recent push from Document360 to Crowdin.

Translating articles in the Crowdin workspace

Once articles are synced, translation work happens in Crowdin:

1. From the Crowdin project home, you can view the current translation status and progress for each target language, and pause translations if needed.
2. Click any target language to see a detailed view of the categories and articles pushed from Document360.
3. Invite team members or external agencies to collaborate directly on the Crowdin platform.
4. Translators can edit or review machine-translated content in Crowdin and push the finished translations back to Document360.

Best practices

• Use the same project name in both Document360 and Crowdin when you first set up the integration. While you can rename projects later, matching names are required for the initial API key validation and make the Push to Crowdin feature work without friction.
• Sync articles in batches rather than all at once when starting out. Begin with a small set of high-priority articles to verify the workflow end-to-end before syncing your full knowledge base.
• Use the Push to Crowdin button from the Document360 article editor whenever you update an article that's already been translated. This keeps translators working from the latest version rather than an outdated copy.
• Set up a Crowdin workflow that includes a review step before content is pushed back to Document360. Machine translations in particular benefit from human review before they go live in your multilingual knowledge base.

FAQ