Guide
Images
Pieces can carry a generated image. You ask for a set, choose the one that works, and decide how it sits against the text — which is a layout decision, not a decorative one.
Generating a set
Image generation produces several options at once rather than one, because the useful question is “which of these” rather than “is this acceptable”. It is a run like any other: it appears in History, it can fail, and it consumes credits.
Every image generated stays in the workspace gallery whether or not you chose it, so nothing is lost by generating a second set and none of it needs regenerating later.
Choosing one
One image per piece is the feature image. Selecting it is reversible at any time, and changing it does not affect the text or the scores.
Layout
Layout decides where the image sits, and it changes how the piece reads. A banner sets up the article; an image beside the text competes with it for attention, which is sometimes what you want.
| Layout | Where the image goes |
|---|---|
Hero | A banner across the top, above the text. |
Inline | Centred within the text, with a caption. |
Feature | Beside the text. You choose whether it sits on the left or the right, and the choice persists as you move between previews. |
Gallery | A grid, for more than one image. |
Full bleed | Edge to edge, with no margin. |
Not every layout suits every format, so the choices offered depend on what you are writing:
| Format | Layouts available |
|---|---|
| Blog, Press release | All five. |
| Doc, Email, Case study | Hero and inline. The others do not survive email clients or print. |
| Social | A single inline card — a social post is one image, by definition. |
Describing the image
An image without a description is invisible to anyone using a screen reader, and the publish check flags it. Describe what the image shows and why it is there — “gritting lorry on a residential street at dawn”, not “image”.
What happens on delivery
When a piece is sent to a destination, the image travels only on json destinations — the html and markdown wire formats carry the body and nothing else. The payload includes a link to the image and the layout you chose.
Receivers must download the image
The gallery
Every image the workspace has generated, in one place, whether or not it was ever chosen. Useful for reusing an image on a later piece instead of paying to generate a near-identical one. Image counts on Reports count everything here, not just the images in use.