Kirby Tools
v3.11.0Hub

Introduction

One-click translation in the Kirby Panel – DeepL, AI providers via Kirby Copilot, or your own backend.

Kirby Content Translator is a plugin for Kirby CMS that adds a translation button to any page, file, or site blueprint. Translate with DeepL or Kirby Copilot for AI – the same pipeline runs from PHP and the CLI for hooks, custom controllers, and batch jobs.

Key Features

  • 🖱️ One-Click Translation: View button in any page, file, or site blueprint.
  • 📦 Batch Translation: All secondary languages at once, from the default.
  • 📄 All Content Types: Pages, files (metadata), and site content.
  • 🧩 Blueprint-Aware: Walks blocks, layout, structure, object, and nested fields. translate: false is respected at any depth.
  • 🏷️ KirbyTags: Translate tag attributes selectively – URLs and UUIDs preserved.
  • ⚡ PHP API: Drive translations from CLI or custom workflows – see PHP classes.
  • 🪝 Hooks: before, after, and warning for preprocessing, postprocessing, and observability.
  • 🔌 Pluggable Strategies: DeepL, AI via Copilot, or your own custom strategy.

How It Works

Add the content-translator Panel view button to your blueprints. The button adapts to the current language context:

  • In secondary languages it offers an Import action (copy content from the default language) and a Translate action (send the current content through the configured provider).
  • In the default language it offers a → All Languages batch action that translates into every other configured language at once.
FeaturePer-Language TranslationBatch Translation
Language ContextSecondary languagePrimary/default language
Translation SpeedReal-time, instantBatch processing
ReversibilityReversible changesNon-reversible
InteractivitySee & edit immediatelyBackground processing
Target LanguagesSingle languageMultiple languages at once
Use CaseFine-tuning translationsInitial content setup

Translation Providers

DeepL

Industry-leading machine translation with a free tier available.

AI Translation

Context-aware translation via the Kirby Copilot plugin (OpenAI, Anthropic, Google, Mistral).

Custom Strategy

Plug in any translation API via a closure or a custom Strategy implementation.

When both DeepL and Kirby Copilot are configured, a dialog lets editors choose the provider per translation.

Get Started

Ready to add translation capabilities to your Kirby project?

Installation Guide

Install the plugin, configure DeepL, and start translating content in minutes.

Installation

Set up DeepL or AI-powered translation, choose your Panel workflow, and start translating content in minutes.