What is the Content CMS?
The Content CMS in Better i18n lets you manage structured multilingual content — articles, blog posts, help docs, product descriptions — in the same platform as your i18n keys.
Translation keys vs. content entries #
Better i18n manages two types of content:
| Type | What it is | Example |
|---|---|---|
| Translation keys | Short strings used in your code | auth.login_button = "Sign in" |
| Content entries | Structured documents with rich bodies | A full help article or blog post |
Most apps use both. Translation keys for UI strings; content entries for longer-form content.
What the Content CMS gives you #
- Content models — define the schema for your content types (custom fields, field types, localized fields)
- Entries — create and manage individual pieces of content
- Multilingual — every entry can have translations in all your project's languages
- Read API + edge cache — content is served from
https://content.better-i18n.com, cached at the edge and purged when you publish - MCP tools — AI agents can create, translate, and publish content directly
- Version history — models can keep a revision per save, so you can look back at what a language said before
How content reaches your app #
Dashboard / MCP agent
→ Create/edit entry with translations
→ Publish
→ Content API cache purged, new version served
→ Your app fetches at runtimeNo rebuild needed. Content updates are live as soon as you publish.
Note which surfaces do what: the dashboard and MCP write content; the Content API only reads it. Your app holds a key that can fetch content and nothing else.
Content API endpoint #
https://content.better-i18n.com/v1/content/{org}/{project}/models/{model}/entriesExample:
curl "https://content.better-i18n.com/v1/content/acme/docs/models/help-article/entries?language=en&status=published" \
-H "x-api-key: YOUR_API_KEY"Two details that save a support ticket: authentication is the x-api-key header (not Authorization: Bearer), and the API does not filter by status on its own — without status=published you get drafts back too.
Who is this for? #
The Content CMS is useful for:
- Documentation sites — help centers, knowledge bases
- Marketing content — landing pages, blog posts
- Product content — feature descriptions, changelogs
- Dynamic content — anything you want to update without redeploying
Better I18N