Gallery editor
The Gallery editor lets you configure a collection of images with a title, caption, layout choice, and per-image metadata. The AI provides a draft structure; you fill in real image URLs and adjust metadata in the widget before saving.
How to invoke it
Ask the AI to create a gallery in natural language:
- “Add an image gallery of Renaissance paintings”
- “Create a slideshow of photos from the Apollo missions”
- “Build a grid gallery of animal cell diagrams”
The AI calls edit_gallery with a pre-filled structure and opens the widget.
Data fields
Gallery
| Field | Type | Required | Notes |
|---|---|---|---|
title | string | Yes | The title of the gallery |
caption | string | Yes | A caption or description shown below the gallery |
layout | "grid" | "slideshow" | "comparison" | Yes | Display mode — see Layout options |
items | array | Yes | The images in the gallery. The AI generates 4 items by default if not specified. |
Each image item
| Field | Type | Required | Notes |
|---|---|---|---|
url | string | Yes | The URL of the image |
title | string | Yes | The title of the image |
caption | string | Yes | A descriptive caption for the image |
credits | string | Yes | Attribution or copyright information |
Layout options
grid — Displays all images simultaneously in a responsive grid. Best for collections where all items are equally important and the viewer should see them at a glance.
slideshow — Displays one image at a time with navigation controls. Best for sequential narratives, step-by-step processes, or when each image deserves focused attention.
comparison — Overlays the images behind a draggable divider that reveals one over the other. Best for before/after pairs or contrasting views of the same subject. It needs at least two images; with one, the gallery is shown as a grid.
Tips
- Provide real URLs. The AI will not generate or invent image URLs. Share links to the images you want to include, or use clearly marked placeholder text (e.g.
[insert image URL here]) and fill them in the widget. - Credits are required. Always provide proper attribution for images, especially for copyrighted or licensed material.
- Captions add context. A good caption explains what the image shows and why it matters — it is not just a repeat of the title.
- Use slideshow for storytelling. If the images form a narrative sequence (step 1/2/3), slideshow layout makes the order explicit.
- Use comparison for before/after. Two images of the same subject, framed alike, work best.