Locale Owl Documentation

Welcome to the Locale Owl documentation. Everything you need to integrate, manage, and scale your translations.

Quick Start

Get up and running with Locale Owl in under 5 minutes:

  1. Create an account — Sign up at localeowl.com and create your first project.
  2. Add languages — Configure your target locales in the Admin UI (e.g. English, Japanese, Korean, Chinese).
  3. Create namespaces — Organize translations by feature area (e.g. landing, dashboard, emails).
  4. Import translations — Upload JSON, CSV, or XLSX files through the Import/Export page.
  5. Publish & deliver — Publish your translations to the CDN and fetch them via the REST API.

Fetch Translations

Once published, translations are available on the global CDN. Fetch them with a simple GET request:

curl https://cdn.localeowl.com/api/namespaces/YOUR_PROJECT_ID/en/landing

Or use the pull script in your build pipeline:

TRANSLATIONS_PROJECT_ID=your-project-id \
TRANSLATIONS_API=https://cdn.localeowl.com \
bun run scripts/pull-translations.ts

Explore the Docs