Quick Reference
AI Providers
| Provider | Configuration Key | Blocks/Layouts | Images |
|---|---|---|---|
google | ⭐ Recommended | ✓ Yes | |
| OpenAI | openai | ✓ Good | ✓ Yes |
| Anthropic | anthropic | ⚠️ Limited | ✓ Yes |
| Mistral | mistral | ⚠️ Limited | ⚠️ Partial |
Default AI Models
Kirby Copilot uses sensible default models for both content generation and inline suggestions if none are specified.
| Provider | Generation Model (model) | Completion Model (completionModel) |
|---|---|---|
| OpenAI | gpt-5.4 | gpt-5.4-nano |
gemini-3.1-pro-preview | gemini-3-flash-preview | |
| Anthropic | claude-sonnet-4-6 | claude-haiku-4-5 |
| Mistral | mistral-small-latest | mistral-small-latest |
Keyboard Shortcuts
| Action | Shortcut |
|---|---|
| Open prompt (writer & textarea field) | . (macOS) / CTRL . (Windows/Linux) |
| Submit prompt | ↵ / CTRL ↵ |
| Cancel generation | Esc |
| Trigger inline suggestion | , (macOS) / CTRL , (Windows/Linux) |
| Accept inline suggestion | ⇥ (Tab) |
| Dismiss inline suggestion | Esc |
| Undo | Z / CTRL Z |
| Redo | Y / CTRL Y |
Prompt History
Your prompts are saved in the browser's local storage (up to 50 entries per site). Access recent prompts via the history dropdown or navigate with arrow keys in the prompt textarea.
| Action | Shortcut |
|---|---|
| Previous prompt | ↑ (when cursor is at the start) |
| Next prompt | ↓ (when cursor is at the end) |
Placeholder Syntax
A placeholder is a field name wrapped in curly braces. When the prompt is sent, each placeholder is resolved with the actual field value from the current model (page, file, or site).
Summarize this article "{title}" in a meta description (max 155 characters). Include the main benefit and end with a subtle call-to-action. No quotes. This is the article:
{content}
Page Reference Syntax
Reference other Kirby pages in your prompt with @page://page-id. The referenced page's content is fetched and appended to your prompt automatically.
Compare these two products:
@page://products/basic
@page://products/pro
Properties
For the full property reference, see:
- View Button & Field Configuration – shared properties (
label,userPrompt,systemPrompt,icon,theme,logLevel) - Copilot Section – section-only properties (
field,editable,files,storage,open,size,help)
Supported Field Types
Kirby Copilot can generate content for all built-in Kirby field types, with the following exceptions:
pages,files,users– Relation fieldsgap,headline,info,line– Blueprint fields without user input
File Attachments
| Type | Handling |
|---|---|
| Images (JPEG, PNG, GIF, WebP) | Auto-resized to a maximum dimension of 2048 pixels |
| PDF documents | Native parsing under 50 MB; text extraction fallback above 50 MB |