Introduction
The Kirby Content Translator plugin empowers editors to translate content from one language to another with a single click. Add the Panel view button to any page, file, or site blueprint and translate content directly in the Kirby Panel using DeepL.

Key Features
- π±οΈ One-Click Translation: Translate content directly from the Panel header with the view button.
- π¦ Batch Translation: Translate to multiple languages simultaneously from the default language.
- π All Content Types: Translate pages, files (metadata), and site content.
- π§© Structure-Aware: Supports blocks, layouts, structures, objects, and nested fields.
- π·οΈ KirbyTags Support: Selectively translate KirbyTag attributes while preserving URLs and UUIDs.
- β‘ PHP API: Automate translations with CLI commands or custom workflows.
- πͺ Hooks System: Customize translation behavior with before/after hooks.
- π Multiple Providers: Built-in DeepL support, AI translation via Kirby Copilot, or custom translation services.
The plugin integrates seamlessly with the Kirby Panel and provides programmatic access via its PHP API.
How It Works
Add the content-translator Panel view button to your blueprints. The button adapts based on your current language context:
In secondary languages two actions appear:
- Import: Copy content from the default language to the current language.
- Translate: Send content to DeepL for translation.
In the default language a batch translation button appears:
- β All Languages: Translate to multiple languages at once
| Feature | Per-Language Translation | Batch Translation |
|---|---|---|
| Language Context | Secondary language | Primary/default language |
| Translation Speed | Real-time, instant | Batch processing |
| Reversibility | Reversible changes | Non-reversible |
| Interactivity | See & edit immediately | Background processing |
| Target Languages | Single language | Multiple languages at once |
| Use Case | Fine-tuning translations | Initial content setup |
Translation Providers
Content Translator supports multiple translation backends:
DeepL
Industry-leading machine translation with 500k free characters/month. Recommended for most projects.
Get Started
Ready to add translation capabilities to your Kirby project?