# Type: Image

Changes to how this Type behaves are requested through a GitHub Issue and implemented, together with this reference page, through the repository's normal workflow. See /_docs/posts for how Post Types and Content Types work in general, and docs/Internal/type-doc-templates.md for the Post Type Doc template this file follows.

A single image, showcased on its own.

## Schema

```
Slots:
- primary : image | required | single
```

A caption is part of the image content itself (see /_docs/content-image), not a separate slot.

## Content placement (Full rendering)

Image has no body text of its own to reference content inline, so this Type has no "Referenced inline" grouping — `primary` is the Post Type's own primary renderer (per the Canonical Post Type contract, docs/Internal/architecture.md), and every other eligible Content Element the Post holds (any additional Image, or any other kind) flows into the same shared "Additional Information" container every other Post Type uses, in the same fixed type-group order. Images are the one documented duplication exception: `primary` itself also appears in the Additional Information Media group (Image/Video/Audio combined), alongside any other Image the Post holds — every other kind still follows the default "shown once" rule.

## Rendering contracts

### Summary (in a list of posts)

Thumbnail of the `primary` image, title, its full caption if present.

### Full (its own page)

The `primary` image at full size, title, the complete caption if present, followed by an "Additional Information" container for anything else the Post holds (see "Content placement" above).

## Page regions (Full rendering)

- **Header** — the Hidden/PrePub/Private banner (if applicable), the title, the compact Published/Updated/Original/History metadata line (see /_docs/article's own "Metadata line" for the full item-by-item detail), and a row of Tag links (if the Version has any — see /_docs/categories's "Tags").
- **Introduction** — the `primary` image and its caption.
- **Supplementary** — the Additional Information container, when eligible content exists.
- **Main**, **Footer** — not currently used by Image.

Responsive order: Header, Introduction, Supplementary — unchanged across viewport sizes (Image has no reading-column primary presentation, so unlike Article, Additional Information here is always a simple after-content block, never a desktop sidebar).

## Public metadata exposure

Title, the `primary` image's caption/metadata, Stage, published/updated timestamps, Tags (as JSON-LD `keywords`) — via the Metadata page and JSON-LD export, same as every Type.

Each Image Content Element's own standalone metadata view (`/_element/image/:id`) additionally shows, when available: original dimensions, format, and file size; a publicly-safe, allowlisted subset of extracted EXIF (camera/lens/exposure facts — device serial numbers and other identifying/operational EXIF fields stay Admin-only); a geolocation map and coordinates when GPS EXIF was captured; and a download link for the original file. There's no per-element geolocation privacy flag in the data model — "public" here means "present on the resolved asset," same as any other technical fact.

## Admin editor

Every Content Element section is available here, same as every Type. The Images section's `primary` role is the image this post displays; anything else you add (another Image under any other role, or any other kind) is still saved and shown, in the Additional Information container (see "Content placement" above).
