Quick Reference

Keyboard shortcuts, properties, and supported field types at a glance.

A quick reference for Kirby Copilot's shortcuts, properties, and capabilities.

AI Providers

Provider	Configuration Key	Blocks/Layouts	Images
Google	`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.2`	`gpt-5-nano`
Google	`gemini-3-pro-preview`	`gemini-3-flash-preview`
Anthropic	`claude-sonnet-4-5-20250929`	`claude-haiku-4-5-20251001`
Mistral	`mistral-large-latest`	`mistral-small-latest`

Google Gemini models are recommended for blocks and layouts due to their superior support for nested JSON schemas.

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`

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}

Learn more about field placeholders.

Properties

Shared Properties

These properties are available for both the view button and Copilot section:

label

String

Custom label for the view button or section. The default depends on the Panel language.

userPrompt

String

Default user prompt that appears when the generation dialog opens. Users can edit the prompt before generating content.

systemPrompt

String

Custom system prompt that controls how the AI structures and formats the generated content. Users cannot see or edit this prompt.

icon

String

Custom icon for the view button or section.

theme

String

Controls the visual appearance and color theme of the button (e.g., blue-icon, positive, negative-icon).

logLevel

String

Set the logging level for debugging AI generation. Options: error, warn, info, debug.

Section-Only Properties

field

String required

Target field name for content generation.

editable

Boolean

Allow prompt editing in the section.

files

Boolean | String

File attachments configuration (true, false, "auto").

storage

Boolean

Persist prompts to local storage.

open

Boolean

Initial accordion state.

size

String

Button size.

help

String

Help text displayed below the section.

Supported Field Types

Kirby Copilot can generate content for all built-in Kirby field types, with the following exceptions:

pages, files, users – Relation fields
gap, headline, info, line – Blueprint fields without user input

File Attachments

Images (JPEG, PNG, GIF, WebP)

Auto-resized to a maximum dimension of 2048 pixels.

Images (JPEG, PNG, GIF, WebP)

Native parsing for files under 50MB; text extraction fallback for larger files.

Blocks & Layouts

Learn how to generate content for blocks and layout fields.