# Type: Category Presentation

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.

The introduction/header content for a Category (see /_docs/categories). A Post of this Type is referenced by a Category's configuration and is deliberately excluded from that Category's own list of posts — it exists only to be shown as the Category's page header.

## Schema

```
Slots:
- avatar       : image   | optional | single
- bio          : text    | required | repeatable (1+)
- presentation : contact | required | repeatable (1+)
```

## Content placement (Full rendering)

`avatar`, `bio`, and `presentation` are this Type's own primary renderer content. Every other eligible Content Element the Post holds flows into the shared "Additional Information" container every other Post Type uses, in the same fixed type-group order (empty groups omitted) — previously anything else added here was stored but never shown at all.

## Rendering contracts

### Summary (in a list of posts)

Not applicable — this Type is never listed.

### Full (its own page)

Title, the `avatar` image, the `bio` text, and the `contact` details, rendered as the category page's header section, followed by an "Additional Information" container for anything else the Post holds (see "Content placement" above).

## Page regions (Full rendering)

- **Header** — the `avatar` image and the title, plus a minimal line showing just the Original item when the Post has applicable language information — no Published/Updated/History items, unlike every other Post Type's own compact metadata line.
- **Introduction** — the `bio` text (one or more blocks).
- **Supplementary** — the `presentation` contact list, followed by the Additional Information container when other eligible content exists.
- **Main**, **Footer** — not currently used by Category Presentation.

Responsive order: Header, Introduction, Supplementary — unchanged across viewport sizes.

## Public metadata exposure

Title, `avatar` image, `bio` text, `presentation` contact entries, Stage, published/updated timestamps, Tags (as JSON-LD `keywords`, though this Type's presentation-chrome nature means Tags aren't shown in its own Full rendering — see /_docs/categories's "Tags") — via the Metadata page and JSON-LD export, same as every Type. Never appears in a Category's own post listing (see "Summary" above).

## Admin editor

Every Content Element section is available here, same as every Type, pre-filled with one block per role above — `bio` and `presentation` are genuinely repeatable, not a fixed set of fields. `avatar`/`bio`/`presentation` fill this Type's own header section; anything else added here is still saved and shown, in the Additional Information container (see "Content placement" above).

## UID

Still has one, like every Post (see /_docs/addressing), for consistency — but since it's never listed or linked to, its own `domain/<uid>` page is not something visitors are expected to reach.