The {{Image}} directive embeds an image from an existing file article into the flow of an article.
Syntax
{{Image file:slug-of-file |#| Layout=full |#| Alt=Descriptive text |#| Caption=Caption text}}
or simply by slug:
{{Image file:slug-of-file}}
Parameters
| Parameter | Required | Description |
|---|---|---|
| Slug (Positional) | Yes | The URL slug of the target file article. Accepts bare slug or file: prefix. |
Layout= |
No | Layout width: full, breakout, or max. Defaults to standard column width. |
Alt= |
No | Alternate text for screen readers and accessibility. Defaults to the file article title. |
Caption= |
No | Caption text associated with the image figure. |
Layout Options
Layout=full— Matches the standard width of the reading column.Layout=breakout— Extends slightly wider than the prose text for visual emphasis.Layout=max— Expands to the maximum available container width, ideal for double-page spreads.
Example
{{Image file:byte-1975-circuit-board |#| Layout=breakout |#| Alt=Close-up of wire-wrapped circuit board |#| Caption=Figure 1: Wire-wrapped prototyping board from the construction article.}}
Tip
If a referenced file article does not exist or has no file attached, the site renders a graceful missing-image.png placeholder.
Return to the Formatting Guide.