A quick reference for Kirby Copilot's shortcuts, options, and capabilities.
| Action | Shortcut |
|---|---|
| Open prompt (writer field) | Cmd + . (macOS) / Ctrl + . (Windows/Linux) |
| Open prompt (textarea field) | . (period key) |
| Submit prompt | Cmd + Enter / Ctrl + Enter |
| Cancel generation | Escape |
| Previous prompt in history | ↑ |
| Next prompt in history | ↓ |
Reference field values in prompts using curly braces:
Write a meta description for "{title}" based on:
{text}
Available in: View button, toolbar buttons, and sections.
These options work for view buttons, sections, and toolbar fields:
| Option | Type | Default | Description |
|---|---|---|---|
label | String | "Copilot" | Custom button/section label |
userPrompt | String | – | Pre-filled prompt text |
systemPrompt | String | – | Hidden AI instructions |
icon | String | sparkling | Custom icon |
theme | String | notice-icon | Visual theme |
logLevel | String | warn | Debug level (error, warn, info, debug) |
| Option | Type | Default | Description |
|---|---|---|---|
field | String | required | Target field name |
editable | Boolean | true | Allow prompt editing |
files | Boolean/String | true | File attachments (true, false, "auto") |
storage | Boolean | true | Persist prompts to localStorage |
open | Boolean | false | Initial accordion state |
size | String | md | Button size |
help | String | – | Help text |
Kirby Copilot can generate content for all built-in field types, excluding the following:
pages, files, users – Relation fieldsgap, headline, info, line – Blueprint fields without user input| File Type | Support |
|---|---|
| Images (JPEG, PNG, GIF, WebP) | Auto-resized to 2048px max |
| PDF (under 50MB) | Native parsing |
| PDF (over 50MB) | Text extraction fallback |
| Provider | Blocks/Layouts | Images | Configuration Key |
|---|---|---|---|
| OpenAI | Limited | Yes | openai |
| Google Gemini | Recommended | Yes | google |
| Anthropic Claude | Good | Yes | anthropic |
| Mistral | Limited | Some models | mistral |