How do I translate content entries?
3 分钟阅读初级
Every content entry can be translated into all of your project's target languages. The content editor lets you work on one language at a time.
Switching languages
- Open a content entry in the editor
- Use the language selector at the top of the page
- Click the target language (e.g., Turkish, French)
- The editor switches to show that language's content
Status indicators next to each language show:
- Filled — translation exists
- Empty — no translation yet
What gets translated?
Always translated (per-language)
- Title — each language has its own title
- Body — the main rich text content
- Localizable custom fields — fields marked as "localizable" when created (e.g., excerpt, SEO description)
Shared across all languages
- Slug — same URL identifier for all languages
- Non-localizable fields — fields like order, reading time, category
- Status — draft/published applies to the whole entry
Translating the body
When you switch to a target language:
- The editor shows the body for that language (empty if not yet translated)
- You can reference the source language body by switching back and forth
- Write the translation in the editor
- It auto-saves per language
Translating custom fields
Localizable custom fields (marked with a globe icon in the model) appear in the metadata sidebar. When you switch languages, these fields show the values for the selected language.
Using AI for content translation
You can use the AI translation features to translate content entries:
- Write your content in the source language
- Use the MCP tools or AI chat to translate the body and custom fields
Example MCP command:
"Translate the help article 'getting-started' body to Turkish"
The AI respects your glossary and translation guidelines.
Translation via API
You can also manage translations programmatically using the Content API:
# Update Turkish translation
PATCH /v1/content/{org}/{project}/entries/{entryId}
{
"languageCode": "tr",
"title": "Başlangıç Kılavuzu",
"bodyMarkdown": "# Başlangıç Kılavuzu\n\n..."
}