Yearbook

Usage

Yearbook displays a directory of people in a responsive grid — each card with a photo, name, job title, short bio, and optional link. Use it for team pages, board listings, speaker rosters, or any hand-curated people directory where you enter each person directly in the editor.

The block inserts with four sample Card entries. Add or remove people with the block inserter; only Card children are allowed.

Yearbook is a block, not a plugin. For full people management with profiles, archives, and dynamic queries, use the Dirigible People plugin instead. Yearbook is the simpler choice when you want a fixed grid you edit manually — similar to building with Columns, but with responsive layout and directory-specific styling built in.

Parent and child blocks

The Yearbook parent (ds/yearbook) holds one or more Card children (ds/yearbook-card).

Select Yearbook for grid layout and shared styling that applies to every card through block context. Select an individual Card to edit that person's photo, name, title, bio, and link.

Grid Settings (parent)

Sidebar controls under Grid Settings:

• Columns — 2, 3, 4 (default), or 5 cards per row. The grid wraps on smaller viewports
• Image Style — Square (default), Rounded, Headshot (large circle), Thumbnail (small circle), or Hidden
• Headline Style — Customizer typography preset for names (h3 appearance by default). Choose hide to suppress the name visually
• Subheadline Style — preset for job titles (h5 appearance by default). Choose hide to suppress the title visually
• Link Style — shared style for card links: Link (understated), Button, Alternate, Hollow, Subtle, Ghost, White, or Outline
• Grid Gap — spacing between cards in rem (0–4; default 2)

Toolbar (parent)

Block toolbar controls not duplicated in the sidebar:

• Alignment — left, center, or right for photos, text, and links within each card
• Toggle Background — adds a subtle rounded background pad on each card
• Toggle Text Size — switches body copy between regular and small for every card
• Columns — quick access to the same column count options as the sidebar

Individual cards (child)

Select a Card child to configure:

• Photo — click the image placeholder, use the toolbar image button, or Change Image in the sidebar. Set Image Focal Point after selecting a photo
• Name — person name, edited inline or in the sidebar (saved as h3; appearance follows parent Headline Style)
• Title — job title or role, edited inline or in the sidebar (saved as h4; appearance follows parent Subheadline Style)
• Body — paragraph and list inner blocks for a short bio
• Link URL — optional link on the card
  • Link Text — default Learn More; edit inline or in the sidebar when a URL is set

Cards without a photo show a default person placeholder on the front end.

Block width

Yearbook supports Wide and Full alignment from the block toolbar and defaults to Wide width.

Tips

• Set Image Style, Headline Style, and Columns on the parent first, then fill in individual card content.
• Use Headshot for classic team grids; Thumbnail for compact directories with more columns.
• Enable Toggle Background when cards sit on a busy Section background.
• Hide names or titles with the hide style option when photos alone identify each person.
• For dated milestones rather than people grids, use Timeline instead.