# Schedule, picture on top list

- **[Sections](/blocks/)**
- **[Schedule](/blocks/schedule/)**
- **Schedule, picture on top list**

One narrow column: a wide picture with a caption, then a label, heading and lead, then dated rows split by thin lines (date, name and line on the left, time and place…

## Import

- **CLI**

  ```
  npx shadcn add @klarhimmel/schedule-picture-top-list
  ```
- **Import**

  ```
  import Block from '@/components/klarhimmel/blocks/schedule-picture-top-list';
  ```

Also called

- schedule/picture-top-list

- **About**: One narrow column: a wide picture with a caption, then a label, heading and lead, then dated rows split by thin lines (date, name and line on the left, time and place on the right), and one or two actions last.
- **Category**: What happens when: sessions, classes or events set out as a list or along a line. New project? Set it up once: /get-started/installation.

## Notes

- **When to use it**: Pick it for a short list of events or sessions in one narrow reading column, with the picture first, then the heading, the rows and the actions last. When the entries need cards in several columns or the actions belong beside the heading, pick `schedule-header-row-list`; for a simple dated history, a changelog block fits better.
- **Writing for it**: - Title up to 80 characters, lead up to 200, between 1 and 10 rows.
- Each row has a date, a name up to 60, a line up to 160, a time and an optional place.
- Write the place as an address or a room, not a sentence.
- **Watch out for**: A long list makes the column very tall and pushes the actions far from the heading, so keep it to about six rows. Leave the place empty when everything happens in one spot and say it in the lead.

## Pairs well with

- **[FAQ, list](/blocks/faq/accordion)**
- **[Call to action, band](/blocks/cta/banner)**
- **[Contact, channels](/blocks/contact/channels)**

## Usage

The block in a page, with its default content (long lists shortened). Every prop is in the table below.

section.tsx

```
import { Theme } from '@/components/klarhimmel/theme/style';
import { BlockSurface } from '@/components/klarhimmel/blocks/surface';
import SchedulePictureTopList from '@/components/klarhimmel/blocks/schedule-picture-top-list';

export default function Section() {
  return (
    <Theme theme="brand">
      <BlockSurface>
        <SchedulePictureTopList props={{
          "media": {
            "src": "/pictures/photo-wood3.avif",
            "alt": "A workbench with hand tools on the wall"
          },
          "caption": "Say what the picture shows in a few words.",
          "eyebrow": "Section name",
          "title": "Say what the schedule is for",
          "description": "Say in one line what the visitor can come to.",
          "items": [
            {
              "date": "Weekday and date",
              "title": "Name the first entry",
              "description": "Say in one line what the visitor gets.",
              "time": "Start and end time",
              "place": "Say where it takes place"
            },
            {
              "date": "Weekday and date",
              "title": "Name the second entry",
              "description": "Say in one line what the visitor gets.",
              "time": "Start and end time",
              "place": "Say where it takes place"
            }
          ],
          "primary": {
            "label": "Main action",
            "href": "#start"
          },
          "secondary": {
            "label": "Second action",
            "href": "#contact"
          }
        }} />
      </BlockSurface>
    </Theme>
  );
}
```

## Props

The type, default and text limit of every prop. On a real page, over-limit text is kept and checkSections flags it (Installation, Check a page before you ship); this live preview shows the default until it fits. The panel above edits all props.

- **media**: See the type.
- **caption**: Text, up to 120 characters.
- **eyebrow**: Text, up to 60 characters.
- **title**: Text, up to 80 characters.
- **description**: Text, up to 200 characters.
- **items**: List of 1 to 10. Each item: date, title, description, time, place.
- **primary**: See the type.
- **secondary**: Optional; empty is not rendered.
- **headingLevel**: One of '1', '2'. Optional; empty is not rendered.

[Previous](/blocks/schedule/header-row-list)

[Next](/blocks/schedule/spine-alternating)
