Translating your docs with AI
Create and publish AI translations that stay synchronized with your source docs.
As far as any good documentation goes, accessibility — and Internationalization (i18n) specifically — plays an important role.
GitBook Agent can translate your documentation into multiple languages and keep it synchronized with its source. You can use built-in translations rather than maintaining a custom translation workflow.
How translations work
A translation in GitBook creates a translated section from a source section. GitBook Agent translates the content and keeps it current.
Whenever you merge changes to your content source, GitBook automatically re-translates only the changed pages. The translated section stays aligned with the source without a separate workflow.
Create a translation
To create a translation:
In your organization Home, click Translations.
Click Create translation.
Under Source, select the section you want to translate.
Select the source language under From.
Select the target language under To.
Click Create.
GitBook will create a translated section and start the translation workflow. The Translations screen shows each workflow’s status, source, runs, translated pages, and word count.
Configure translation instructions
If you want to add custom instructions to a translation, before you click Create, click Show advanced instructions to set optional translation guidance.
Add custom AI instructions
Use custom instructions to guide tone, style, and other translation preferences. GitBook Agent will always follow and preserve the source structure.
Custom instructions cannot add content, create new elements, or change the structure from the source content.
Add a glossary
Add glossary terms to keep product terminology consistent. Each term must use the source-language wording.
For example, an English glossary can map SSO to SSO and Git Sync to Git Sync. GitBook Agent then keeps those terms unchanged in translated output.
Changing a glossary triggers a full re-translation. This can increase processing time and cost.
Publish the translated docs
Add the translated section to variant on your site so visitors can switch languages.
To add the translation, follow these steps:
In the site sidebar, under General, click Site structure.
Select the source section you’ve translated and click Add variant, then open the Use existing content tab
Search for the translated section, hover over it and choose Use as content.
Give your variant a title and click Add variant.
Optionally, change the slug of your variant.
Once undrafted and published, your users can then select the language from the published site’s language switcher.
Understand translation limits and pricing
You can’t edit translated content directly. Use custom AI instructions and the glossary to improve translated output.
Translations don’t localize variant UI elements automatically. In the site sidebar, open Customize under Tools to localize the interface for each variant.
Translations are billed monthly or annually:
$25 per month includes 50,000 translated words each month.
$250 per year includes 50,000 translated words each month.
Additional translation costs $0.20 per 1,000 words.
Your first translation counts every word. Later runs charge for pages containing new or updated words. A small change on a large page re-translates the entire page, but not the entire section.
FAQ
Last updated
Was this helpful?